Agent Versions

Promote Production Label

Move the production label to the latest version, or to the version identified by version (or prompt_id).

post/v1/agents/{agent_id}/versions/promote

Path parameters

agent_idinteger required

Query parameters

versioninteger nullable

If set, attach the production label to this version number; otherwise attach to the latest version.

If set, attach the production label to this version number; otherwise attach to the latest version.

prompt_idstring uuid nullable

Alias for version: the version's uuid. Ignored when version is set.

Alias for version: the version's uuid. Ignored when version is set.

Headers

X-Organization-Idstring
X-API-Keystring required

API key required to authenticate requests.

Response

Successful Response

idstring uuid nullable

the id of the prompt

prompt_textstring required

the prompt content

commit_messagestring nullable
labelsstring[] nullable

labels associated with the prompt

metadataobject nullable

arbitrary JSON metadata

versioninteger required

the version number of the prompt

agent_idinteger required

id of the agent that owns this prompt

Changes

Changed in 1 of the 38 revisions of this API.1