Sign in

v3

OpenAPI 3.1.02026-07-31350397683.8 KB
Prompts

Promote Production Label Agent Scoped

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

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

Path parameters

agent_idinteger required

Query parameters

prompt_idstring uuid nullable

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

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

Headers

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