Auth failures (401/403)

Use this playbook when Relay API calls return a 401 or 403 response.

Likely causes

• x-api-key header missing or malformed
• API key is for the wrong environment (test vs prod)
• Bearer token sent to an endpoint that expects x-api-key

Checklist

1. Confirm the request uses the x-api-key header.
2. Verify the correct base URL for your environment.
3. Remove any bearer tokens from Relay requests.
4. Retry the request and confirm the status changes.

Escalation

If it still fails, open a ticket and include:

• trace_id/request_id
• endpoint + timestamp
• HTTP status + error message