Authentication

API requests authenticate with a bearer token:

Authorization: Bearer br_your_key

Create, view, and revoke API keys from:

https://app.batchrelay.com/developers

Scopes

Scope	Purpose
print_orders:write	Create print orders.
print_orders:read	Read print-order status.
usage:read	Read usage summary.
webhooks:read	Read webhook configuration.
webhooks:write	Create or change webhook configuration.

Missing keys

Requests without an API key return:

{
  "error": {
    "code": "api_key_required",
    "message": "Supply a Batch Relay API key using Authorization: Bearer <key>.",
    "docs_url": "https://docs.batchrelay.com/errors#api_key_required",
    "action_url": "https://app.batchrelay.com/developers"
  },
  "request_id": "req..."
}

Revocation

Revoked keys stop working immediately. Create a new key if a bearer token is exposed.