Create Page Job

Submit a page creation request (manual spec or prompt mode). Processing happens asynchronously.


POST /api/page-jobs

Authentication

Required. API key or browser session.

Required headers

Idempotency-Key: required, non-empty.

Request body

Exactly one of components or prompt must be provided.


{
  "slug": "my-page",
  "title": "My Page",
  "components": [
    {
      "type": "hero",
      "props": {
        "headline": "Hello"
      }
    }
  ],
  "theme": {
    "preset": "clean-modern"
  }
}

Prompt mode example:


{
  "slug": "ai-page",
  "prompt": "A portfolio page for a photographer with a dark theme",
  "model": "gpt-5.2"
}

Response

Status: 202 Accepted


{
  "job": {
    "id": "uuid",
    "type": "single",
    "status": "queued",
    "parentJobId": null,
    "triggerRunId": "run_123",
    "attemptCount": 0,
    "maxAttempts": 3,
    "pageId": null,
    "result": null,
    "error": null,
    "createdAt": "2026-02-23T00:00:00.000Z",
    "startedAt": null,
    "completedAt": null
  }
}

Job status values

queued
running
succeeded
failed
cancelled

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
429	Prompt rate limit exceeded	Prompt requests exceeded hourly limit
503	Rate limit check failed	Temporary backend issue