에이전트 브랜치 업데이트

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": "string",
  "name": "string",
  "agent_id": "string",
  "description": "string",
  "created_at": 1,
  "last_committed_at": 1,
  "is_archived": true,
  "protection_status": "writer_perms_required",
  "auto_rebase": false,
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin",
    "access_source": "creator"
  },
  "current_live_percentage": 0,
  "parent_branch": {
    "id": "string",
    "name": "string"
  },
  "most_recent_versions": [
    {
      "id": "string",
      "agent_id": "string",
      "branch_id": "string",
      "version_description": "string",
      "seq_no_in_branch": 1,
      "time_committed_secs": 1,
      "parents": {
        "in_branch_parent_id": "string",
        "out_of_branch_parent_id": "string",
        "merged_into_branch_id": "string",
        "merged_from_branch_id": "string",
        "merged_from_version_id": "string",
        "rebased_from_version_id": "string"
      },
      "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": "string",
          "creator_email": "string",
          "role": "admin",
          "anonymous_access_level_override": "admin",
          "access_source": "creator"
        }
      ]
    }
  ]
}

이름, 설명, 보관 상태, 보호 수준, main으로의 자동 리베이스 등 에이전트 브랜치 속성을 업데이트합니다.

경로 매개변수

agent_idstring필수

에이전트의 ID입니다. 에이전트 생성 시 반환됩니다.

branch_idstring필수

브랜치의 고유 식별자입니다.

요청

This endpoint expects an object.

namestring or null선택 사항1-140 characters

브랜치의 새 이름입니다. 에이전트 내에서 고유해야 합니다.

descriptionstring or null선택 사항<=4096 characters

브랜치의 새 설명입니다. 빈 문자열을 전달하면 지울 수 있습니다.

is_archivedboolean or null선택 사항

브랜치를 보관할지 여부입니다.

protection_statusenum or null선택 사항기본값 writer_perms_required

브랜치의 보호 수준

허용된 값:

auto_rebaseboolean or null선택 사항

true이면 새 기본 브랜치 버전이 생성될 때마다 이 브랜치를 기본 브랜치로 자동 리베이스합니다. 기본 브랜치에서는 활성화할 수 없습니다.

응답

성공 응답

idstring

namestring

agent_idstring

descriptionstring

created_atinteger

last_committed_atinteger

is_archivedboolean

protection_statusenum선택 사항기본값 writer_perms_required

허용된 값:

auto_rebaseboolean선택 사항기본값 false

access_infoobject or null선택 사항

브랜치의 액세스 정보

current_live_percentagedouble선택 사항기본값 0

브랜치에서 라이브 상태인 트래픽 비율

parent_branchobject or null선택 사항

브랜치의 상위 브랜치

most_recent_versionslist of objects선택 사항

브랜치의 최신 버전

오류

422

Unprocessable Entity Error

경로 매개변수

헤더

요청

응답

오류