에이전트 브랜치 업데이트

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

경로 매개변수

헤더

요청

응답

오류