Skip to content

Error reference

Your role cannot grant that scope

You asked for a scope your own role cannot use, so the key would fail the first time it was used. Remove it, or ask an owner to create the key.

Code
insufficient_role_for_scope
HTTP status
403
Category
forbidden
Severity
error
Retryable
No
Domain
api-access

How to fix

Review the request and try again. The response `detail` explains the specific problem.

Example response

Every error is returned as application/problem+json (RFC 9457). The detail is the specific, actionable message; the code is stable and safe to branch on.

{
  "type": "https://skedcast.com/errors/insufficient_role_for_scope",
  "title": "Your role cannot grant that scope",
  "status": 403,
  "category": "forbidden",
  "code": "insufficient_role_for_scope",
  "detail": "You asked for a scope your own role cannot use, so the key would fail the first time it was used. Remove it, or ask an owner to create the key.",
  "correlationId": "c-1f2e3d4c-…",
  "severity": "error"
}

Handle it in code

try {
  await skedcast.posts.create(input);
} catch (err) {
  if (err instanceof SkedcastApiError && err.code === 'insufficient_role_for_scope') {
    // You asked for a scope your own role cannot use, so the key would fail the first time it was used. Remove it, or ask an owner to create the key.
  }
}