Skip to main content
POST
Publish an agent
Publish after saving and testing the draft. Validation errors identify the items to correct before trying again. Publishing changes which definition production outbound API routes execute. See test and publish. The success body contains the definition id, version_number, status, and published_at. The definition ID is different from the agent ID. If no draft exists, publishing activates the already released definition.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Path Parameters

workflow_id
integer
required

Response

Successful Response

id
integer
required
published_at
string<date-time> | null
required
status
string
required
version_number
integer
required