Skip to main content
Flow AgentsVersion: v3

Promote to Production

POST/agent-studio/agent/versions/{versionId}/publish

Promotes a draft version to production.

Authorizations

Authorizationstringheaderrequired

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

Scope:agent-studio.write
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Path Parameters

versionIdstringrequired

Draft/staging version ID to promote to production and publish

Example:v1a2b3c4d5e6f7g8h9i0

Query Parameters

sourcestring

Origin channel attributed to this write for auditing (e.g. public_api, internal)

Example:api

Body

locationIdstringrequired

Location ID for authorization

Example:C2QujeCh8ZnC7al2InWR
userIdstring

User ID performing the promotion action

Example:usr_abc123def456
userNamestring

User name performing the promotion action

Example:John Doe
userEmailstring

User email performing the promotion action

Response

Version promoted and published successfully

successbooleanrequired

Success status

Example:true
messagestringrequired

Response message

Example:Draft published to production successfully. New draft version created for future edits.
dataobjectrequired

Result data with production and new draft version details