Skip to content

Error reference

Authentication required

You need to sign in to do that.

Code
unauthenticated
HTTP status
401
Category
auth
Severity
error
Retryable
No
Domain
auth

How to fix

Sign in again to continue — your session is no longer valid.

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/unauthenticated",
  "title": "Authentication required",
  "status": 401,
  "category": "auth",
  "code": "unauthenticated",
  "detail": "You need to sign in to do that.",
  "correlationId": "c-1f2e3d4c-…",
  "severity": "error",
  "action": "login"
}

Handle it in code

try {
  await skedcast.posts.create(input);
} catch (err) {
  if (err instanceof SkedcastApiError && err.code === 'unauthenticated') {
    // You need to sign in to do that.
  }
}