Errors

{
  "type": "https://neuraldraft.com/errors/insufficient-scope",
  "title": "Forbidden",
  "status": 403,
  "detail": "This API key does not have the required scope: blog:write.",
  "code": "insufficient_scope",
  "required_scope": "blog:write"
}

{
  "message": "The slug field is required. (and 1 more error)",
  "errors": {
    "slug": ["The slug field is required."],
    "title": ["The title field is required."]
  }
}

{
  "type": "https://neuraldraft.com/errors/payment-required",
  "title": "Payment Required",
  "status": 402,
  "detail": "Insufficient credits.",
  "code": "insufficient_credits",
  "cost": 60,
  "balance": 12
}

async function withRetry<T>(fn: () => Promise<T>, max = 5): Promise<T> {
  for (let attempt = 0; ; attempt++) {
    try {
      return await fn();
    } catch (err: any) {
      const retryable = err?.status === 429 || err?.status >= 500;
      if (!retryable || attempt + 1 >= max) throw err;
      const after = Number(JSON.parse(err?.body || "{}").retry_after);
      const delay = Number.isFinite(after) ? after * 1000 : Math.random() * Math.min(30_000, 250 * 2 ** attempt);
      await new Promise((r) => setTimeout(r, delay));
    }
  }
}

curl -X POST https://api.neuraldraft.io/v1/products \
  -H "Authorization: Bearer $NEURALDRAFT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"name":"Seeded rye","price":520,"currency":"gbp"}'