Agents

Pin Agent Version

PUT/v2/agents/{agent_id}/pin

ENG-1219 §4.1: point the agent at one of its versions. New tasks then run that version's definition (spec P6) until the pin moves. Manage gate + id-scoped version read, in that order (404 before any write; no existence oracle for other agents' versions). Not a configuration change: no capture mark is enqueued.

Path Parameters

agent_idstring · uuidrequired

Request Body

version_idstring · uuidrequired

Request

curl --request PUT \
  --url https://api.brainbaselabs.com/v2/agents/{agent_id}/pin \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "version_id": "9e94c502-ca41-4342-a7f7-af96b444512c"
}'