Sign in

v3

OpenAPI 3.1.02026-07-31350397683.8 KB
Prompts

Create Prompt Version Agent Scoped

create a new prompt version under /agents/{agent_id}/prompts/versions.

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

Path parameters

agent_idinteger required

Headers

X-API-Keystring required

API key required to authenticate requests.

Request body

prompt_textstring required
commit_messagestring nullable
labelsstring[] nullable
metadataobject nullable

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