Error reference

Service unavailable

Could not check background service health. Please try again.

Code: worker_health_unavailable
HTTP status: 503
Category: retry
Severity: warn
Retryable: Yes
Domain: common

How to fix

Wait a moment and try the request again.

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/worker_health_unavailable",
  "title": "Service unavailable",
  "status": 503,
  "category": "retry",
  "code": "worker_health_unavailable",
  "detail": "Could not check background service health. Please try again.",
  "correlationId": "c-1f2e3d4c-…",
  "severity": "warn",
  "action": "retry"
}

Handle it in code

try {
  await skedcast.posts.create(input);
} catch (err) {
  if (err instanceof SkedcastApiError && err.code === 'worker_health_unavailable') {
    // Could not check background service health. Please try again.
  }
}