Skip to main content
WEBHOOK

Body

application/json
id
string<uuid>
required

The ID of the API Key.

name
string
required

The name of the API Key.

Example:

"Default API Key"

key
string
required

The API Key.

Example:

"f9e67690304c23f133f7d965f130139d36f985b1ce8169a7d8ed99dbd5edc3b9"

default_request_mode
enum<string>
required

The default execution mode for requests authenticated with this API key. 'sync' means requests block until completion; 'async' means requests return immediately with a 202 status. The Prefer header overrides this default.

Available options:
sync,
async
Examples:

"async"

"sync"

__event__
WebhookMetadata · object
federation_grants
enum<string>[] | null

Federation grants scoping this key. Populated only on federation API keys; null for organization and operator keys.

Capabilities granted to a federation-owner API key.

Populated only on APIKey rows where owner == Federation; NULL elsewhere. A federation key must have at least one grant.

Available options:
sandbox,
production,
admin
organization_grants
enum<string>[] | null

Surfaces this organization key may reach ('api' for the customer HTTP API, 'exports' for the SFTP bulk data feed). Null means unscoped: full API access and no SFTP. Always null on federation and operator keys.

Surfaces an organization-owner API key may reach (ENG-6872).

NULL means ungranted — the historical blanket behavior: the full customer API, and no SFTP. Every key minted before this column existed is NULL, which is what makes the column backwards compatible by construction.

A non-NULL set is authoritative and must be non-empty. Populated only on rows where owner == Organization; NULL elsewhere.

Available options:
api,
exports

Response

Successful Response