Skip to main content
POST
Promote Production Label
Integration Prompt for AI Agents
New: POST /v1/agents/{agent_id}/versions/promoteDeprecated: POST /v1/agents/{agent_id}/prompts/promote. Old path, still works.
Moves the production label to the latest agent version, or to the version number in the version query parameter. The old prompt_id query (the version uuid) still works but is deprecated and ignored when version is set.

Headers

X-Organization-Id
string
X-API-Key
string
required

API key required to authenticate requests.

Path Parameters

agent_id
integer
required

Query Parameters

version
integer | null

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

prompt_id
string<uuid> | null

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

Response

Successful Response

response model for prompt without created_at.

prompt_text
string
required

the prompt content

version
integer
required

the version number of the prompt

agent_id
integer
required

id of the agent that owns this prompt

id
string<uuid> | null

the id of the prompt

commit_message
string | null
labels
string[] | null

labels associated with the prompt

metadata
Metadata · object | null

arbitrary JSON metadata