Agents and agent keys
20 operations. Each page has its parameters, body, errors and examples.
- GET
/v1/organisations/{id}/agentsThe organisation's agents and their keys: who each acts for, scope, expiry, last use - POST
/v1/organisations/{id}/agents/{agentId}/revokeRevoke an agent and every key it holds - POST
/v1/organisations/{id}/agent-keys/{keyId}/revokeRevoke one agent key - PATCH
/v1/organisations/{id}/agent-keys/{keyId}Shorten a key's expiry, lower its spend cap or set its IP allow-list - GET
/v1/organisations/{id}/agent-keys/{keyId}/activityOne key's record: what its requests did, and its use per day - GET
/v1/me/agent-keysAgent keys that act for the person, across organisations - POST
/v1/agents/challengesA challenge to solve (sign-up) and a proof of work (sign-up and delegation) - POST
/v1/agents/signupsSign up: the answer, the proof of work, a mailbox you can read and the terms; a code is mailed - POST
/v1/agents/signups/{signupId}/resendA new code by mail (three at most, a minute apart) - POST
/v1/agents/signups/{signupId}/verifyThe mailed code for your agent, its sandbox organisation, its first key (shown once) and the claim link - POST
/v1/agents/delegationsAsk an existing person for a key that acts for them (device code: they approve one screen) - POST
/v1/agents/delegations/tokenPoll for the key: authorization_pending, slow_down, access_denied, expired_token, or the key once - GET
/v1/agents/meWho this key is, who it acts for and what it may do - GET
/v1/agents/me/keysThe agent's keys, with use in the last 30 days - POST
/v1/agents/me/keysAnother key (never more than this one may do), shown once - POST
/v1/agents/me/keys/{keyId}/rotateA new secret; the old one works ten more minutes - POST
/v1/agents/me/keys/{keyId}/revokeRevoke one of the agent's keys - POST
/v1/agents/me/claim-linkA fresh claim link to give your person (the last one stops working) - GET
/v1/agents/me/sites/templatesThe site template library (with each template's live demo) - POST
/v1/agents/me/sites/previewsCompose a site from a template, never made: an hour's preview link