更新智能体分支

PATCH

/v1/convai/agents/:agent_id/branches/:branch_id

PATCH

/v1/convai/agents/:agent_id/branches/:branch_id

curl -X PATCH https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/branches/agtbranch_0901k4aafjxxfxt93gd841r7tv5t \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "id": "id",
  "name": "name",
  "agent_id": "agent_id",
  "description": "description",
  "created_at": 1,
  "last_committed_at": 1,
  "is_archived": true,
  "protection_status": "writer_perms_required",
  "auto_rebase": true,
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin",
    "anonymous_access_level_override": "admin",
    "access_source": "creator"
  },
  "current_live_percentage": 1.1,
  "parent_branch": {
    "id": "id",
    "name": "name"
  },
  "most_recent_versions": [
    {
      "id": "id",
      "agent_id": "agent_id",
      "branch_id": "branch_id",
      "version_description": "version_description",
      "seq_no_in_branch": 1,
      "time_committed_secs": 1,
      "parents": {},
      "access_info": {
        "is_creator": true,
        "creator_name": "John Doe",
        "creator_email": "john.doe@example.com",
        "role": "admin",
        "access_source": "creator"
      },
      "merged_authors": [
        {
          "is_creator": true,
          "creator_name": "John Doe",
          "creator_email": "john.doe@example.com",
          "role": "admin",
          "access_source": "creator"
        }
      ]
    }
  ]
}

更新智能体分支属性，例如名称、描述、归档状态、保护级别，以及自动变基到 main。

路径参数

agent_idstring必需

智能体 ID。创建智能体时返回此值。

branch_idstring必需

分支的唯一标识符。

请求

This endpoint expects an object.

namestring可选1-140 characters

分支新名称。必须在该智能体内唯一。

descriptionstring可选<=4096 characters

分支的新描述。传入空字符串即可清除。

is_archivedboolean可选

是否应归档该分支

protection_statusenum可选默认为 writer_perms_required

分支保护级别

允许的值:

auto_rebaseboolean可选

为 true 时，每次新的主分支版本发布后，都会自动将此分支变基到主分支。不能在主分支上启用。

响应

成功响应

idstring

namestring

agent_idstring

descriptionstring

created_atinteger

last_committed_atinteger

is_archivedboolean

protection_statusenum可选默认为 writer_perms_required

允许的值:

auto_rebaseboolean可选默认为 false

access_infoobject可选

分支访问信息

current_live_percentagedouble可选默认为 0

分支上已上线的流量百分比

parent_branchobject可选

该分支的父分支

most_recent_versionslist of objects可选

分支上的最新版本

错误

422

Branches Update Request Unprocessable Entity Error

路径参数

请求头

请求

响应

错误