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.
- insufficient_role_for_scope
- 403
- forbidden
- error
- No
- 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.
}
}