Skip to main content
PATCH
Update version label

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id
string<uuid>
required

Voice agent ID.

Example:

"550e8400-e29b-41d4-a716-446655440000"

version_number
integer
required

Agent config version number.

Required range: x >= 1

Body

application/json

The label is the only mutable field on a version.

label
string | null

New label. Whitespace is trimmed; null or an empty string clears the label.

Maximum string length: 120

Response

Updated version.

id
string<uuid>
required
Example:

"550e8400-e29b-41d4-a716-446655440000"

voice_agent_id
string<uuid>
required
Example:

"550e8400-e29b-41d4-a716-446655440000"

version_number
integer
required

Monotonically increasing version number, unique per agent.

Required range: x >= 1
config_schema_version
integer
required

Format version of the config document recorded for this version.

config_hash
string
required

Content hash of the version's config document.

changed_fields
string[]
required

Top-level config fields that changed relative to the previous version.

source
enum<string>
required

The operation that recorded this version.

Available options:
baseline,
create,
update,
rollback,
duplicate,
import,
credential_normalization
actor_type
enum<string>
required
Available options:
client,
admin,
system
created_at
string<date-time>
required
Example:

"2026-01-15T10:30:00Z"

code_dependency_hash
string | null
restored_from_version
integer | null

For rollback versions, the version number that was restored.

label
string | null

Optional human-readable label.

Maximum string length: 120