API_KEY_SCOPE

The API key is valid but not allowed to do this.

HTTP status	403
Group	Platform
Retryable	No — sending it again changes nothing

What happened

Keys carry scopes. A relay key needs a plan that can sponsor any sender (Builder and up, Agent Pro, Agent Fleet), and pays only for the receivers and functions on its allow-lists.

What to do

Use a key with the right scope, move to a plan that can sponsor, or widen the key’s allow-lists in the dashboard.

The problem document

Every error is application/problem+json (RFC 9457) with the same shape:

{
  "type": "https://docs.co-relayer.com/errors/api-key-scope",
  "title": "The API key is valid but not allowed to do this.",
  "status": 403,
  "detail": "A sentence about this specific occurrence.",
  "instance": "req_01JB…",
  "code": "API_KEY_SCOPE",
  "retryable": false,
  "hint": "Use a key with the right scope, move to a plan that can sponsor, or widen the key’s allow-lists in the dashboard."
}

See the error model for what each member means and how to handle unknown codes.