Sign in
Prompts

Get Prompt By Label Agent Scoped

retrieve a single prompt by label under /agents/{agent_id}/prompts?label=... .

  • if label is missing -> 400
  • if label resolves to 0 -> 404; >1 -> 400 ambiguous (except latest which should be unique)
get/v1/agents/{agent_id}/prompts

Path parameters

agent_idinteger required

Query parameters

labelstring nullable

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

Changes

No changes recorded. 1 of the 20 revisions has no diff computed, so it could not be searched.