v1

latestOpenAPI 3.1.02026-07-223261135.0 KB
tasks

List Tasks

List recent design tasks (cursor-paginated, newest first).

get/tasks

Query parameters

cursorstring nullable

Opaque pagination cursor. Pass the next_cursor from the previous response. Omit on the first request.

Opaque pagination cursor. Pass the next_cursor from the previous response. Omit on the first request.

limitinteger

Max tasks per page. Defaults to 20, caps at 100.

Max tasks per page. Defaults to 20, caps at 100.

canvas_idstring nullable

Prefixed cvs_ wire ID (Crockford base32 body) — the canonical, recommended form. For back-compat, a bare UUID string is also accepted in both path parameters and JSON request bodies (older integrations that stored raw UUIDs keep working). Both are permanent, supported inputs.

Example:cvs_01HT9WK8N3M2J4A5Z6P7Q8R9TV
statusstring nullable

Headers

Moda-Version'2026-04-12' | '2026-05-01'
Example:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Response

Successful Response

next_cursorstring nullable

Opaque cursor for the next page; null when the end of the list is reached.

Example response

{
  "data": [
    {
      "id": "task_01HT9WK8N3M2J4A5Z6P7Q8R9TV"
    }
  ]
}