Agents
Enable or disable an agent credential
Toggles the kill-switch. Disabling drops live connections within seconds.
AuthorizationBearer <token>
JWT issued by Better Auth. Verified via JWKS.
In: header
Path Parameters
project_id*string
Unique project identifier (prefixed, e.g. prj_xxx).
agent_id*string
Unique agent credential identifier (prefixed, e.g. agt_xxx).
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request body for enabling or disabling an agent credential.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/v1/projects/string/agents/string" \ -H "Content-Type: application/json" \ -d '{ "status": "active" }'{ "id": "agt_01h455vb4pex5vsknk084sn02q", "project_id": "prj_01h455vb4pex5vsknk084sn02q", "policy_profile_id": "pol_01h455vb4pex5vsknk084sn02q", "name": "Claude Code (analytics)", "pg_username": "agent_a1b2c3d4e5f6", "status": "active", "principal_type": "agent", "auth_method": "cleartext", "last_used_at": "2019-08-24T14:15:22Z", "expires_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}{ "error": { "code": "string", "message": "string" }}{ "error": { "code": "string", "message": "string" }}{ "error": { "code": "string", "message": "string" }}{ "error": { "code": "string", "message": "string" }}