Skip to main content
GET
/
v1
/
api-keys
List API keys
curl --request GET \
  --url https://api.example.com/v1/api-keys

Documentation Index

Fetch the complete documentation index at: https://docs.causeflow.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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"
    }
  ]
}
FieldTypeDescription
keyIdstringUnique identifier for the API key
namestringThe descriptive name assigned at creation
prefixstringThe first few characters of the key, for identification only
statusstringKey status: active or revoked
createdAtstringISO 8601 timestamp of when the key was created

​
Examples

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