Error reference

Draft not ready

SkedCast AI could not draft chapters from these subtitles. No credit was used — try again, or add the chapters by hand.

Code: chapters_draft_failed
HTTP status: 502
Category: retry
Severity: warn
Retryable: Yes
Domain: agencies

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/chapters_draft_failed",
  "title": "Draft not ready",
  "status": 502,
  "category": "retry",
  "code": "chapters_draft_failed",
  "detail": "SkedCast AI could not draft chapters from these subtitles. No credit was used — try again, or add the chapters by hand.",
  "correlationId": "c-1f2e3d4c-…",
  "severity": "warn"
}

Handle it in code

try {
  await skedcast.posts.create(input);
} catch (err) {
  if (err instanceof SkedcastApiError && err.code === 'chapters_draft_failed') {
    // SkedCast AI could not draft chapters from these subtitles. No credit was used — try again, or add the chapters by hand.
  }
}