Pin this agent's prompt to a version, or track latest
Set version_mode and the pin together, in one UPDATE.
Separate from PUT on purpose: folding them would let a content edit silently change resolution mode.
The target is a version_number resolved within THIS agent’s prompt, so a
number belonging to another agent 404s rather than pinning across a tenancy
boundary. version_mode and pinned_version_id are assigned together so
ck_agent_prompt_pin_consistent is never transiently violated — a CHECK
violation would be a 500, so this validates first and the CHECK is the
backstop.
Authorizations
Enter your API key (e.g. dai_sk_test_key_001)
Path Parameters
Cookies
Body
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.
Response
Successful Response
The response is of type Response Pin Agent Prompt Api V1 Agents Agent Name Prompt Pin Post · object.