Skip to main content
POST
Publish the current draft

Authorizations

Authorization
string
header
required

Workspace API key issued from the web app. Pass as Authorization: Bearer YOUR_API_KEY.

Path Parameters

agent_id
string<uuid>
required

UUID of the agent.

Response

Newly published version.

A single version in an agent group's history.

id
string<uuid>
required

Agent ID of this version. Use this id with /agents/{agent_id} endpoints to address this specific version.

agent_group_id
string<uuid>
required
version_number
integer
required
status
enum<string>
required

Lifecycle status of an agent version.

  • draft — work-in-progress, not yet runnable for end users
  • published — live, runnable
  • archived — superseded by a newer version
Available options:
draft,
published,
archived
name
string
required
is_active
boolean
required
created_at
string<date-time>
required
updated_at
string<date-time>
required