List Retriever API Keys

List all API keys for this retriever.

Fields:

• key_id: Public identifier for the key
• key_prefix: First 10 characters + ”…” for identification (e.g., “ret_sk_abc…”)
• name: Human-friendly label
• created_at: When the key was created
• last_used_at: When the key was last used (if ever)
• status: ACTIVE, REVOKED, or EXPIRED
• expires_at: Expiration timestamp (if set)

Note:

• Plaintext key is NEVER returned in list responses
• Only shown once in creation response
• Use key_prefix to identify keys in the UI

GET /v1/retrievers/{retriever_id}/api-keys

List Retriever API Keys

cURL

curl --request GET \
  --url https://api.mixpeek.com/v1/retrievers/{retriever_id}/api-keys

200

{
  "results": [
    {
      "key_hash": "<string>",
      "internal_id": "<string>",
      "user_id": "<string>",
      "name": "<string>",
      "key_id": "<string>",
      "key_prefix": "sk_abc123...",
      "key_type": "standard",
      "subscription_id": "<string>",
      "organization_id": "<string>",
      "description": "",
      "permissions": [],
      "scopes": [
        {
          "resource_id": "<string>",
          "operations": []
        }
      ],
      "rate_limit_override": 123,
      "status": "active",
      "expires_at": "2023-11-07T05:31:56Z",
      "last_used_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "created_by": "<string>",
      "revoked_at": "2023-11-07T05:31:56Z",
      "revoked_by": "<string>",
      "allowed_origins": [
        "https://docs.example.com",
        "https://*.example.com"
      ],
      "principal_id": "<string>"
    }
  ],
  "total": 0
}

Headers

Authorization · string

REQUIRED: Bearer token authentication using your API key. Format: 'Bearer sk_xxxxxxxxxxxxx'. You can create API keys in the Mixpeek dashboard under Organization Settings.

Examples:

"Bearer YOUR_API_KEY"

"Bearer YOUR_STRIPE_API_KEY"

authorization · string

X-Namespace · string

Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like 'my-namespace'. Falls back to ?namespace= query parameter if the header is omitted.

Examples:

"ns_abc123def456"

"production"

"my-namespace"

Path Parameters

retriever_id · string · required

Query Parameters

include_revoked · boolean · default: false

Include revoked and expired keys in the response

Response

200

application/json

Successful Response

Response for listing retriever API keys.

results · APIKeyModel · object[]

List of API keys for the retriever (plaintext key never included).

Show child attributes

total · integer · default: 0

Total number of keys (including revoked if requested).