Skip to navigation

Request agent capabilities

Request additional approval for read_account or read_organization. Follow the returned device approval flow when status is pending. Limited to 30 requests per IP per hour. See the AI-agents guide. Agent Auth JWTs are not API-key exchange tokens.

Request

This endpoint expects an object.
capabilitieslist of strings or objectsRequired
reasonstringOptional
preferred_methodenumOptional
Allowed values:
login_hintstringOptional
binding_messagestringOptional

Response

Protocol response.
agent_idstring
statusstring
agent_capability_grantslist of objects
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