Skip to main content
POST
Push a configuration bundle

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

Push a configuration bundle to a version, committing a new revision.

caller
enum<string>
required
Available options:
agent_builder,
ui,
cli
bundle
Bundle · object
required

Versioned agent configuration bundle. Must include 'schema_version' and 'general_settings'.

commit_message
string | null
Maximum string length: 4000

Response

Successful Response

Result of a push: the new revision's identity and content digest.

agent_id
string
required
Pattern: ^[0-9a-fA-F]{24}$
version_id
string
required
Pattern: ^[0-9a-fA-F]{24}$
new_version_revision_number
integer
required
new_version_tag
string
required
revision_id
string
required

Id of the newly committed revision

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

Hex-encoded SHA-256 of the canonical bundle bytes

size
integer
required
created_at
string<date-time>
required
commit_message
string | null