Get API Key

GET

keys

{key_id}

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

{
  "id": "key_9f8a7b6c",
  "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",
  "instances": [
    {
      "instance_id": "inst_abc123",
      "permissions": ["read", "interact", "channels"]
    },
    {
      "instance_id": "inst_def456",
      "permissions": ["read", "interact", "channels"]
    }
  ]
}

Look up a single API key by ID. This endpoint returns the full picture — key metadata plus which instances the key can access and with what permissions.

Authorization

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

Path Parameters

string

required

The ID of the key to retrieve.

Response

string

Unique identifier for the key.

string

The human-readable name assigned at creation.

string

The key prefix (chd_sk_).

boolean

Whether the key is currently active.

string | null

Expiration datetime, if one was set.

string | null

The last time this key was used to authenticate a request.

string

When the key was created.

object[]

The instances this key has access to, along with the granted permissions.

Show Instance object

string

The instance this access grant applies to.

string[]

The permission scopes granted for this instance (e.g. ["read", "interact"]).

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

{
  "id": "key_9f8a7b6c",
  "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",
  "instances": [
    {
      "instance_id": "inst_abc123",
      "permissions": ["read", "interact", "channels"]
    },
    {
      "instance_id": "inst_def456",
      "permissions": ["read", "interact", "channels"]
    }
  ]
}

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

{
  "id": "key_9f8a7b6c",
  "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",
  "instances": [
    {
      "instance_id": "inst_abc123",
      "permissions": ["read", "interact", "channels"]
    },
    {
      "instance_id": "inst_def456",
      "permissions": ["read", "interact", "channels"]
    }
  ]
}

Overview

Organization

Instances

Channels

Skills

Files

API Keys

Subscription

Authorization

Path Parameters

Response

​Authorization

​Path Parameters

​Response

Authorization

Path Parameters

Response