Skip to content
Documentation/API reference
API · keys

List keys

GET /api/v2/keys

Authorization

Authenticated user session (use inboxit login). Use the CLI login flow; a workspace API key cannot call this operation.

Parameters

All resource access is checked against the selected workspace and user permissions.

Request

Run inboxit login first. The CLI supplies authenticated user credentials.

Example
inboxit keys list

Response

HTTP 200. Example values are illustrative; excerpts are marked.

Example
{
  "keys": []
}

Behavior & errors

Key metadata: id, name, prefix, scopes, created_at, expires_at, revoked_at. Operators receive an empty list. Tokens are never returned here. Common errors: 400 invalid input, 401 unauthenticated, 403 insufficient permission, 404 missing/inaccessible resource, 409 conflict, 429 rate/usage limit, 503 service unavailable. See Errors & retries for recovery guidance.