Get agent branch

curl https://api.elevenlabs.io/v1/convai/agents/agent_id/branches/branch_id \
     -H "xi-api-key: xi-api-key" \
     -H "Content-Type: application/json"

{
  "id": "branch_8f7a6d4c9b2e4f1a",
  "name": "Feature Update Branch",
  "agent_id": "agent_3701k3ttaq12ewp8b7qv5rfyszkz",
  "description": "Branch for implementing the new conversational flow update.",
  "created_at": 1688006400,
  "last_committed_at": 1688592000,
  "is_archived": false,
  "protection_status": "writer_perms_required",
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin"
  },
  "current_live_percentage": 25.5,
  "parent_branch": {
    "id": "branch_4d3c2b1a9e8f7d6c",
    "name": "Main Branch"
  },
  "most_recent_versions": [
    {
      "id": "version_1234abcd5678efgh",
      "agent_id": "agent_3701k3ttaq12ewp8b7qv5rfyszkz",
      "branch_id": "branch_8f7a6d4c9b2e4f1a",
      "version_description": "Added new greeting intents and updated fallback responses.",
      "seq_no_in_branch": 5,
      "time_committed_secs": 1688592000,
      "parents": {
        "in_branch_parent_id": "version_1234abcd5678efgg",
        "out_of_branch_parent_id": null,
        "merged_into_branch_id": null,
        "merged_from_branch_id": null
      },
      "access_info": {
        "is_creator": true,
        "creator_name": "John Doe",
        "creator_email": "john.doe@example.com",
        "role": "admin"
      }
    }
  ]
}

Get information about a single agent branch

Path parameters

agent_idstringRequired

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

branch_idstringRequired

Unique identifier for the branch.

Response

Successful Response

idstring

namestring

agent_idstring

descriptionstring

created_atinteger

last_committed_atinteger

is_archivedboolean

protection_statusenum or null

Allowed values:

access_infoobject or null

Access information for the branch

current_live_percentagedouble or nullDefaults to 0

Percentage of traffic live on the branch

parent_branchobject or null

Parent branch of the branch

most_recent_versionslist of objects or null

Most recent versions on the branch

Path parameters

Headers

Response

Errors