Skip to navigation

Get agent status

Poll approval status and capability grants. With a host JWT, agent_id is required; with an agent JWT, the target is the signing agent. Limited to 120 requests per IP per minute. See the AI-agents guide. Agent Auth JWTs are not API-key exchange tokens.

Query parameters

agent_idstringOptional

Response

Protocol response.
agent_idstring
statusstring
agent_capability_grantslist of objects
host_idstring or nullOptional
namestringOptional
modestringOptional
user_idstring or nullOptional
activated_atstring or nullOptional
created_atstring or nullOptional
last_used_atstring or nullOptional
expires_atstring or nullOptional
approvalobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
503
Service Unavailable Error