keys.list
List a shop's named agent keys (owner only): label, scopes, audience, when made, last used (last_used_at, to the minute; null and never_used true if the key was never used) and revoked. Keys don't expire; revoke a key the shop no longer uses. The key itself is never returned. Filter by audience (any or mcp) or include revoked keys.
When to use it
List a shop's named agent keys (owner only): label, scopes, audience, when made, last used (last_used_at, to the minute; null and never_used true if the key was never used) and revoked. Keys don't expire; revoke a key the shop no longer uses.
What to tell the owner
Tell them what you found in plain words. Don't read back raw fields.
| Field | Type | Required |
|---|
shop_id | string | yes |
audience | string (one of any, mcp) | no |
include_revoked | boolean | no |
Example
GET https://doingwork.work/v1/keys?shop_id=00000000-0000-4000-8000-000000000000
Output
| Field | Type | Always there |
|---|
keys | array | yes |
keys[].key_id | string | yes |
keys[].label | string | yes |
keys[].scopes | array | no |
keys[].audience | string (one of any, mcp) | no |
keys[].created_at | string | no |
keys[].used_at | ['string', 'null'] | no |
keys[].last_used_at | ['string', 'null'] | yes |
keys[].never_used | boolean | yes |
keys[].revoked_at | ['string', 'null'] | no |
keys[].terms_version | string | no |
keys[].accepted_at | string | no |
{
"keys": [
{
"key_id": "00000000-0000-4000-8000-000000000000",
"label": "...",
"last_used_at": "...",
"never_used": true
}
]
}
Errors
| Code | Status | What to do |
|---|
invalid_input, invalid_token, rate_limited | | Can happen on any call. See errors. |