Skip to main content
PATCH
Update a version

Authorizations

Authorization
string
header
required

Access token from POST /management/v1/auth/token (publishable-key exchange) or a login session. Publishable-key tokens are agent-scoped and serve the messaging surface; login tokens also serve management.

Path Parameters

agentId
string
required
Pattern: ^[0-9a-fA-F]{24}$
versionId
string
required
Pattern: ^[0-9a-fA-F]{24}$

Body

application/json

Update mutable fields (label, tags, notes) on a version.

label
string | null
tags
string[] | null
notes
string | null

Response

Successful Response

Returns the updated version.

id
string
required

Version id

Pattern: ^[0-9a-fA-F]{24}$
agent_id
string
required

Owning agent id

Pattern: ^[0-9a-fA-F]{24}$
version_number
integer
required
version_revision_number
integer
required
version_tag
string
required

Canonical tag, e.g. 'v3.2'

status
enum<string>
required
Available options:
draft,
published,
archived
created_at
string<date-time>
required
parent_version_id
string | null

Lineage: cloned from

Pattern: ^[0-9a-fA-F]{24}$
label
string | null
tags
string[]
notes
string | null
stats
VersionStats · object | null

Counts of the entities configured in a version.

published_at
string<date-time> | null