v8

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-05730512.7 KB

API Keys

List API keys

List the API keys for the tenant. Tokens are masked in this response — the full token is only returned when you create or rotate a key. Callers without API-key management permission see only their own key. The response is a bare JSON array ordered by most recent creation time.

get/v1/api-keys

Response

A bare JSON array of API key objects (tokens masked).

uuidstring uuid

You receive the UUID for this API key.

namestring

You receive the API key name.

environmentstring

You receive the environment for this key: sandbox or prod.

rolestring

You receive the role granted to this key.

created_atstring date-time

You receive the timestamp when the key was created.

member_emailstring

You receive the member email the key belongs to, or an empty string for a tenant-level key.

token_last4string

You receive the last 4 characters of the token.

maskedstring

You receive the masked token for display.

Example response

[
  {
    "uuid": "d1e2f3a4-b5c6-7d80-9e1f-2a3b4c5d6e7f",
    "name": "default",
    "environment": "sandbox",
    "role": "owner",
    "created_at": "2026-07-02T23:51:58.746686+00:00",
    "member_email": "dev@acme.example",
    "token_last4": "s9Zx",
    "masked": "sk_••••••••s9Zx"
  }
]