GET/1.0/tasks

Lists the tasks in the key's workspace, newest change first. Required scope: workbench:flows:run (scopes reference).

Most integrations call this once, keep the id of the task they care about, and then only ever start runs against it. A task's id is the same one the Workbench UI shows.

Query parameters

limitintegerdefault: "100"

Page size, up to 500. See pagination.

cursorstring

The nextCursor from the previous response. Omit for the first page.

Response (200)

dataarray

The page of tasks. Each carries id, name, the sentence it was written as, its status, createdAt / updatedAt, and the current plan.

nextCursorstring | null

Pass as cursor for the next page. null on the last one.

curl "https://api.zerowidth.ai/1.0/tasks?limit=25" \
  -H "Authorization: Bearer zw_live_abc12345_..."

{
  "data": [
    {
      "id": "cmpd9k2x10001...",
      "name": "Weekly billing reconciliation",
      "sentence": "Every Monday, pull last week's invoices and flag anything that doesn't match the ledger.",
      "status": "ACTIVE",
      "createdAt": "2026-09-01T09:12:44.000Z",
      "updatedAt": "2026-09-15T16:02:10.000Z"
    }
  ],
  "nextCursor": null
}

Errors

Uses the shared error envelope. A bad cursor returns 400 validation; auth and scope problems return 401 and 403 scope_missing.

1 min read