C
ChowAPI

Authentication

All API requests require an API key in the Authorization header.

Header format

Authorization: Bearer chow_live_YOUR_KEY

Key prefixes

PrefixEnvironmentUsage
chow_live_ProductionLive API calls, metered for billing
chow_test_TestingLocal development, not metered

Getting started

Sign up at chowapi.dev, purchase a credit pack or subscribe to pay-as-you-go, and create an API key from your dashboard.

Credit packs: $5/5K calls (Dev), $20/25K calls (Builder), $50/100K calls (Scale). Pay-as-you-go: $0.002/call metered monthly.

Key management

Authenticated users (via Supabase JWT) can create, rename, and revoke API keys:

# Create a new key
POST /v1/account/keys
{ "name": "My App" }

# Rename a key
PATCH /v1/account/keys/{key_id}
{ "name": "Production" }

# Revoke a key
DELETE /v1/account/keys/{key_id}

Each account can have up to 5 active keys. API keys are hashed with SHA-256 before storage. The plaintext key is shown only once at creation.

Error responses

// Missing or invalid key
{
  "error": {
    "code": "auth/missing_key",
    "message": "No API key provided.",
    "suggestion": "Add an Authorization header: Bearer chow_live_YOUR_KEY",
    "docs": "https://chowapi.dev/docs/authentication"
  }
}