Skip to main content
POST
Pin this agent's prompt to a version, or track latest

Authorizations

Authorization
string
header
required

Enter your API key (e.g. dai_sk_test_key_001)

Headers

Authorization
string
X-Workspace-Id
string | null

Path Parameters

agent_name
string
required

Cookies

decimal_session
string | null

Body

application/json

Body of POST /api/v1/agents/{agent_name}/prompt/pin.

The pin target is a version_number resolved WITHIN this agent's prompt, never a bare version_id from the body — an id supplied by the caller is a tenancy leak dressed as a pin.

version_mode
string
required

'pinned' or 'latest'.

version_number
integer | null

Required when version_mode='pinned'.

Required range: x >= 1

Response

Successful Response

The response is of type Response Pin Agent Prompt Api V1 Agents Agent Name Prompt Pin Post · object.