List API Keys

GET

keys

curl https://api.chowder.dev/v1/keys \
  -H "Authorization: Bearer chd_sk_your_org_key"

[
  {
    "id": "key_9f8a7b6c",
    "organization_id": "org_1a2b3c4d",
    "name": "Production Bot Key",
    "key_prefix": "chd_sk_",
    "is_active": true,
    "expires_at": "2026-12-31T23:59:59Z",
    "last_used_at": "2026-02-14T08:30:00Z",
    "created_at": "2026-02-14T12:00:00Z"
  },
  {
    "id": "key_3e4f5g6h",
    "organization_id": "org_1a2b3c4d",
    "name": "Dev Testing Key",
    "key_prefix": "chd_sk_",
    "is_active": false,
    "expires_at": null,
    "last_used_at": null,
    "created_at": "2026-01-10T09:15:00Z"
  }
]

Fetch every API key associated with your organization. Handy for auditing access or building a key management UI.

Authorization

Requires an organization-level API key in the Authorization header.

Response

Returns an array of key objects. Note that the raw key value is never included — we only store hashes, so what you see is what you get.

string

Unique identifier for the key.

string

The organization this key belongs to.

string

The human-readable name assigned at creation.

string

The key prefix (chd_sk_).

boolean

Whether the key is currently active. Revoked or expired keys will show false.

string | null

Expiration datetime, if one was set.

string | null

The last time this key was used to authenticate a request. null if the key has never been used.

string

When the key was created.

curl https://api.chowder.dev/v1/keys \
  -H "Authorization: Bearer chd_sk_your_org_key"

[
  {
    "id": "key_9f8a7b6c",
    "organization_id": "org_1a2b3c4d",
    "name": "Production Bot Key",
    "key_prefix": "chd_sk_",
    "is_active": true,
    "expires_at": "2026-12-31T23:59:59Z",
    "last_used_at": "2026-02-14T08:30:00Z",
    "created_at": "2026-02-14T12:00:00Z"
  },
  {
    "id": "key_3e4f5g6h",
    "organization_id": "org_1a2b3c4d",
    "name": "Dev Testing Key",
    "key_prefix": "chd_sk_",
    "is_active": false,
    "expires_at": null,
    "last_used_at": null,
    "created_at": "2026-01-10T09:15:00Z"
  }
]

curl https://api.chowder.dev/v1/keys \
  -H "Authorization: Bearer chd_sk_your_org_key"

[
  {
    "id": "key_9f8a7b6c",
    "organization_id": "org_1a2b3c4d",
    "name": "Production Bot Key",
    "key_prefix": "chd_sk_",
    "is_active": true,
    "expires_at": "2026-12-31T23:59:59Z",
    "last_used_at": "2026-02-14T08:30:00Z",
    "created_at": "2026-02-14T12:00:00Z"
  },
  {
    "id": "key_3e4f5g6h",
    "organization_id": "org_1a2b3c4d",
    "name": "Dev Testing Key",
    "key_prefix": "chd_sk_",
    "is_active": false,
    "expires_at": null,
    "last_used_at": null,
    "created_at": "2026-01-10T09:15:00Z"
  }
]

Overview

Organization

Instances

Channels

Skills

Files

API Keys

Subscription

Authorization

Response

​Authorization

​Response

Authorization

Response