Products

Runs list

Page through standalone generation jobs and product runs in one newest-first list.

GET /v1/runs

Lists everything that ran in the current project, newest first: standalone generation jobs and product runs, merged. Each product run carries its step jobs, and those step jobs don’t appear as separate rows. This is the list the dashboard’s Runs page shows.

Scope: generation:read

The per-kind lists are still available at GET /v1/generation/requests and GET /v1/workflows/runs. This is the only one of the three with cursor pagination.

Query

limitintegerdefault:50

Rows per page, from 1 to 200. Values outside that range are clamped.

sourcestring

Narrow the list. api: standalone jobs submitted with an API key. studio: standalone jobs submitted from the dashboard. workflow: product runs only. Omit for everything.

cursorstring

The next_cursor from the previous page. Omit for the first page.

X-Windpaint-Projectstring

The project to list, by id or slug. Defaults to your organization’s default project.

Response

Returns {"data": {"items": [...], "total": ..., "next_cursor": ...}}.

itemsRunItem[]required

One page of rows, newest first.

totalintegerrequired

The number of rows matching source across all pages.

next_cursorstring | nullrequired

Pass as cursor to get the next page. null when this page has fewer than limit rows. When a page is exactly full, next_cursor is set and the next page may come back empty.

A cursor this endpoint didn’t produce returns 422 with Invalid cursor.

Response

200

{
  "data": {
    "items": [
      {
        "kind": "workflow",
        "id": "d4f6a8c0-2e4b-4d6f-8a1c-3e5b7d9f1a2c",
        "status": "running",
        "source": "workflow",
        "credits": { "estimate": "4.08", "actual": null },
        "error": null,
        "created_at": "2026-10-04T15:02:11.430Z",
        "finished_at": null,
        "request": null,
        "run": {
          "id": "d4f6a8c0-2e4b-4d6f-8a1c-3e5b7d9f1a2c",
          "status": "running",
          "product": "text-to-clip",
          "product_version": 1,
          "project_id": "5a8b2c4d-6e1f-4a3b-9c7d-0e2f4a6b8c1d",
          "inputs": { "idea": "A paper boat drifting down a rain-soaked street", "aspect": "16:9" },
          "steps": [
            { "key": "still", "capability": "image.generate", "op": null, "model": "z-image-turbo", "status": "running", "request_id": "0b2d4f6a-8c1e-4a3c-9e5f-7b9d1f3a5c7e", "outputs": [], "error": null },
            { "key": "frame", "capability": null, "op": "image.resize", "model": null, "status": "pending", "request_id": null, "outputs": [], "error": null },
            { "key": "clip", "capability": "video.generate", "op": null, "model": "wan-2.2-i2v", "status": "pending", "request_id": null, "outputs": [], "error": null },
            { "key": "cover", "capability": null, "op": "video.extract_frame", "model": null, "status": "pending", "request_id": null, "outputs": [], "error": null }
          ],
          "outputs": {},
          "credits": { "estimate": "4.08", "actual": null },
          "error": null,
          "status_url": "https://api.windpaint.ai/v1/workflows/runs/d4f6a8c0-2e4b-4d6f-8a1c-3e5b7d9f1a2c",
          "cancel_url": "https://api.windpaint.ai/v1/workflows/runs/d4f6a8c0-2e4b-4d6f-8a1c-3e5b7d9f1a2c/cancel",
          "created_at": "2026-10-04T15:02:11.430Z",
          "started_at": "2026-10-04T15:02:11.912Z",
          "finished_at": null
        },
        "jobs": [
          {
            "status": "in_progress",
            "request_id": "0b2d4f6a-8c1e-4a3c-9e5f-7b9d1f3a5c7e",
            "capability": "image.generate",
            "model": "z-image-turbo",
            "project_id": "5a8b2c4d-6e1f-4a3b-9c7d-0e2f4a6b8c1d",
            "workflow_run_id": "d4f6a8c0-2e4b-4d6f-8a1c-3e5b7d9f1a2c",
            "step_key": "still",
            "source": "workflow",
            "outputs": [],
            "images": [],
            "video": null,
            "credits": { "estimate": "0.08", "actual": null },
            "error": null,
            "created_at": "2026-10-04T15:02:11.912Z",
            "finished_at": null
          }
        ]
      },
      {
        "kind": "generation",
        "id": "b2d4e6f8-1a3c-4e5f-8a7b-9c0d1e2f3a4b",
        "status": "completed",
        "source": "api",
        "credits": { "estimate": "0.08", "actual": "0.08" },
        "error": null,
        "created_at": "2026-10-04T14:19:52.004Z",
        "finished_at": "2026-10-04T14:19:56.871Z",
        "request": {
          "status": "completed",
          "request_id": "b2d4e6f8-1a3c-4e5f-8a7b-9c0d1e2f3a4b",
          "capability": "image.generate",
          "model": "z-image-turbo",
          "project_id": "5a8b2c4d-6e1f-4a3b-9c7d-0e2f4a6b8c1d",
          "workflow_run_id": null,
          "step_key": null,
          "source": "api",
          "outputs": [
            { "id": "3f6c1a52-8e0b-4d7a-9c21-5b7e2f4a9d10", "url": "https://api.windpaint.ai/v1/generation/assets/3f6c1a52-8e0b-4d7a-9c21-5b7e2f4a9d10/content", "content_type": "image/png", "width": 1024, "height": 768, "duration_s": null }
          ],
          "images": [
            { "id": "3f6c1a52-8e0b-4d7a-9c21-5b7e2f4a9d10", "url": "https://api.windpaint.ai/v1/generation/assets/3f6c1a52-8e0b-4d7a-9c21-5b7e2f4a9d10/content", "content_type": "image/png", "width": 1024, "height": 768, "duration_s": null }
          ],
          "video": null,
          "credits": { "estimate": "0.08", "actual": "0.08" },
          "error": null,
          "created_at": "2026-10-04T14:19:52.004Z",
          "finished_at": "2026-10-04T14:19:56.871Z"
        },
        "run": null,
        "jobs": []
      }
    ],
    "total": 37,
    "next_cursor": "MjAyNi0xMC0wNFQxNDoxOTo1Mi4wMDQwMDArMDA6MDB8YjJkNGU2ZjgtMWEzYy00ZTVmLThhN2ItOWMwZDFlMmYzYTRi"
  }
}

To fetch every page, repeat the request with cursor set to the last next_cursor until it comes back null or items is empty:

curl "https://api.windpaint.ai/v1/runs?limit=50&cursor=MjAyNi0xMC0wNFQxNDoxOTo1Mi4wMDQwMDArMDA6MDB8YjJkNGU2ZjgtMWEzYy00ZTVmLThhN2ItOWMwZDFlMmYzYTRi" \
  -H "Authorization: Bearer $WINDPAINT_API_KEY"