Workflows

Check status of a website-creation workflow

Poll the status of a website-creation workflow started via POST /v1/ai/workspace/website. Aggregates the home page plus every additional page: status is only complete when every page has succeeded, partial if the website exists but one or more pages failed.

get/v1/ai/workspace/website/status/{workflow_id}

Request

  • Base URL: https://api.lindo.ai
  • URL: https://api.lindo.ai/v1/ai/workspace/website/status/{workflow_id}
  • Auth: HTTP bearer

Path parameters

workflow_idstring required

The workflow_id returned by the create-website endpoint

Example:wf_abc123xyz789

Response

Status retrieved

successtrue required

The status poll succeeded. This is independent of whether the workflow itself succeeded; check status for that.

doneboolean required

True once the workflow has reached a terminal state (complete, partial, or errored). While false, clients should poll again after poll_after_ms.

status'scheduled' | 'running' | 'complete' | 'partial' | 'errored' required
  • scheduled: queued to run in the future
  • running: currently executing
  • complete: fully finished with no errors
  • partial: finished, but some sub-steps (e.g. individual pages of a website) failed
  • errored: the workflow itself failed
workflow_idstring required

The workflow_id you polled

messagestring required

Human-readable, safe-to-quote status message. Agents can surface this directly to end users.

poll_after_msnumber

When done is false, suggested delay before the next status check, in milliseconds. Absent when done is true.

errorstring

When status is errored, a machine-readable error message

Example response

{
  "success": true,
  "done": true,
  "status": "complete",
  "workflow_id": "wf_abc123xyz789",
  "message": "Page published at /about",
  "poll_after_ms": 5000,
  "result": {
    "website_id": "website_def456",
    "website_name": "Acme Bakery",
    "domain": "https://acmebakery.com",
    "home_page_id": "page_home_abc",
    "pages_summary": {
      "total": 5,
      "complete": 4,
      "errored": 1
    },
    "pages": [
      {
        "page_id": "page_xyz789",
        "slug": "about",
        "path": "/about",
        "status": "complete"
      }
    ]
  },
  "error": "Insufficient credits: daily limit reached"
}

Changes

No recorded changes to this operation across all 1 revision of this API.