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.

WhoAgents can call this
RESTGET /v1/keys
MCP toolkeys_list
Writesno
AreaSign-in and agent access

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.

Input

FieldTypeRequired
shop_idstringyes
audiencestring (one of any, mcp)no
include_revokedbooleanno

Example

GET https://doingwork.work/v1/keys?shop_id=00000000-0000-4000-8000-000000000000

Output

FieldTypeAlways there
keysarrayyes
keys[].key_idstringyes
keys[].labelstringyes
keys[].scopesarrayno
keys[].audiencestring (one of any, mcp)no
keys[].created_atstringno
keys[].used_at['string', 'null']no
keys[].last_used_at['string', 'null']yes
keys[].never_usedbooleanyes
keys[].revoked_at['string', 'null']no
keys[].terms_versionstringno
keys[].accepted_atstringno
{
  "keys": [
    {
      "key_id": "00000000-0000-4000-8000-000000000000",
      "label": "...",
      "last_used_at": "...",
      "never_used": true
    }
  ]
}

Errors

CodeStatusWhat to do
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.