Bulk Create Page Jobs

Submit up to 10 page specs in a single async batch request.


POST /api/page-jobs/bulk

Authentication

Required. API key or browser session.

Required headers

Idempotency-Key: required, non-empty.

Request body


{
  "pages": [
    {
      "slug": "page-one",
      "components": [
        { "type": "hero", "props": { "headline": "Page 1" } }
      ]
    },
    {
      "slug": "page-two",
      "prompt": "A product launch page with pricing and testimonials"
    }
  ]
}

Response

Status: 202 Accepted


{
  "job": {
    "id": "batch-job-id",
    "type": "batch",
    "status": "running"
  },
  "children": [
    {
      "id": "child-job-1",
      "type": "batch_item",
      "status": "queued",
      "parentJobId": "batch-job-id"
    },
    {
      "id": "child-job-2",
      "type": "batch_item",
      "status": "failed",
      "parentJobId": "batch-job-id",
      "error": {
        "code": "RATE_LIMIT",
        "message": "Prompt generation rate limit exceeded for this batch"
      }
    }
  ]
}

Each child page runs independently and can succeed/fail independently.

Get child statuses


GET /api/page-jobs/{jobId}/children

Errors

Status	Error	When
400	Missing `Idempotency-Key` / invalid body	Input invalid
401	Not authenticated	Missing or invalid auth
409	Idempotency conflict	Same key reused with different payload
503	Rate limit check failed	Temporary backend issue