Update agent branch

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",
  "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"
      }
    }
  ]
}

Update agent branch properties such as archiving status and protection level

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",
  "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"
      }
    }
  ]
}

Update agent branch properties such as archiving status and protection level

Path parameters

agent_idstringRequired

The id of an agent. This is returned on agent creation.

branch_idstringRequired

Unique identifier for the branch.

Request

This endpoint expects an object.

namestringOptional1-140 characters

New name for the branch. Must be unique within the agent.

is_archivedbooleanOptional

Whether the branch should be archived

protection_statusenumOptionalDefaults to writer_perms_required

The protection level for the branch

Allowed values:

Response

Successful Response

idstring

namestring

agent_idstring

descriptionstring

created_atinteger

last_committed_atinteger

is_archivedboolean

protection_statusenumDefaults to writer_perms_required

Allowed values:

access_infoobject

Access information for the branch

current_live_percentagedoubleDefaults to 0

Percentage of traffic live on the branch

parent_branchobject

Parent branch of the branch

most_recent_versionslist of objects

Most recent versions on the branch

Errors

422

Branches Update Request Unprocessable Entity Error

Update agent branch

Path parameters

Headers

Request

Response

Errors

Path parameters

Headers

Request

Response

Errors

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

1	{
2	"id": "id",
3	"name": "name",
4	"agent_id": "agent_id",
5	"description": "description",
6	"created_at": 1,
7	"last_committed_at": 1,
8	"is_archived": true,
9	"protection_status": "writer_perms_required",
10	"access_info": {
11	"is_creator": true,
12	"creator_name": "John Doe",
13	"creator_email": "john.doe@example.com",
14	"role": "admin",
15	"anonymous_access_level_override": "admin",
16	"access_source": "creator"
17	},
18	"current_live_percentage": 1.1,
19	"parent_branch": {
20	"id": "id",
21	"name": "name"
22	},
23	"most_recent_versions": [
24	{
25	"id": "id",
26	"agent_id": "agent_id",
27	"branch_id": "branch_id",
28	"version_description": "version_description",
29	"seq_no_in_branch": 1,
30	"time_committed_secs": 1,
31	"parents": {},
32	"access_info": {
33	"is_creator": true,
34	"creator_name": "John Doe",
35	"creator_email": "john.doe@example.com",
36	"role": "admin",
37	"access_source": "creator"
38	}
39	}
40	]
41	}