List API keys

List all API keys for the current tenant.

GET /v1/api-keys

List API keys

cURL

curl --request GET \
  --url https://api.example.com/v1/api-keys

Overview

Returns all API keys for the current tenant. This is useful for auditing which integrations have active keys and identifying keys to revoke.

Required role: Any authenticated user

The plaintext key is never returned after creation. Only the prefix is shown for identification. If you need the full key value, revoke the existing key and create a new one.

Response

Returns 200 OK with an array of API keys.

{
  "keys": [
    {
      "keyId": "key_01HX9VTPQR3KF8MZWBYD5N6JCE",
      "name": "Datadog webhook",
      "prefix": "cflo_abc",
      "status": "active",
      "createdAt": "2026-03-10T14:00:00Z"
    },
    {
      "keyId": "key_02JY0WUQRS4LG9NAXCZE7O7KDF",
      "name": "PagerDuty integration",
      "prefix": "cflo_xyz",
      "status": "active",
      "createdAt": "2026-02-01T09:00:00Z"
    }
  ]
}

Field	Type	Description
keyId	string	Unique identifier for the API key
name	string	The descriptive name assigned at creation
prefix	string	The first few characters of the key, for identification only
status	string	Key status: active or revoked
createdAt	string	ISO 8601 timestamp of when the key was created

Examples

curl

curl https://api.causeflow.ai/v1/api-keys \
  -H "Authorization: Bearer <token>"