## Documentation Index

Fetch the complete documentation index at: [/llms.txt](https://help.trykarat.com/llms.txt)

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

The Payout API authenticates every request with an API key passed as a bearer token. Requests without a valid key return `401 Unauthorized`.

## Generate an API key

API keys are managed from your Karat dashboard under **Settings**. From there you can:

- Generate a new key
- View your existing keys
- Revoke a key that may have been compromised

Your API key is shown only once at creation time. Copy it and store it somewhere secure immediately — you can’t retrieve it again later.

## Authorize requests

Include your key in the `Authorization` header as a bearer token on every request:

```
curl https://payouts.api.trykarat.com/recipients \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Storing keys securely

- Never commit API keys to source control or embed them in client-side code.
- Load keys from environment variables or a secrets manager.
- Use separate keys for sandbox and production.
- Rotate keys periodically, and revoke any key that may be exposed.

Each key is scoped to the organization and user that created it. Revoking a key takes effect immediately for all future requests.
