'API tokens (API keys): list, revoke, delete, rotate'

Kody API tokens (kody_at_…, sometimes called API keys) authenticate the Open API, the CLI, and CI. There is no account UI for them: you manage them with these Open API operations.

Scopes apply when the caller is itself an API token. The MCP api tool runs as you, so it can list and revoke any of your tokens.

Revoke a token

1. List tokens and find the one to revoke by name, scopes, or last_used_at:

   { "operationId": "tokenList" }

2. Revoke it by id (the part after kody_at_ and before _):

   { "operationId": "tokenRevoke", "params": { "token_id": "<id>" } }

Revoking is how you delete a token. Revocation is immediate. Anything still using the token gets 401 API token was revoked.

Where to call these

• MCP api tool (preferred for connected agents): pass the JSON above.
• CLI: npx @kodycodes/cli api tokenList and npx @kodycodes/cli api tokenRevoke --params '{"token_id":"<id>"}' after npx @kodycodes/cli login (see Local CLI execute). Interactive kody login prefers the login session and deletes a leftover stored kody_at_ bootstrap token. kody whoami reports the active credential. KODY_API_TOKEN in the environment still wins over both.
• HTTPS: GET /v1/tokens and DELETE /v1/tokens/{token_id} on api.kody.codes with a token that holds token:read / token:delete.

Token operations are not kody.* capabilities, so execute (hosted or --local) cannot call them, and search lists this guide rather than a capability.

Only search and execute in your tool list?

Kody's MCP server advertises search, execute, and api to every signed-in account on every plan; nothing gates api by tier, scope, or client. If your agent only sees search and execute, its MCP client has not picked up the current tool list.

• ChatGPT: ChatGPT does not refresh Kody's tool list after reconnect, so api stays missing. Add Kody in developer mode (see Connect your agent), or use the Kody CLI: npx @kodycodes/cli api tokenList and npx @kodycodes/cli api tokenRevoke --params '{"token_id":"<id>"}'.
• Other clients: refresh the Kody server's tools (reconnect it, or restart the client) and api appears. Until then, use the CLI commands above.