List Tasks

List tasks for the authenticated caller's assistant with cursor pagination. Results are ordered by order_by and return next_page when additional rows are available. Use the optional status and project_id filters to narrow the result set.

limitinteger nullable

Maximum number of tasks in this page. Default is 50; valid range is 1 to 100.

pagestring nullable

Opaque cursor from a previous list response. Omit for the first page. IMPORTANT: Reuse with the same order_by, status, and project_id values.

order_by'created_at' | 'updated_at'

Sort key for pagination boundaries. Use updated_at (default) for recency feeds. Use created_at for creation-order views.

status'pending' | 'in_progress' | 'completed' | 'canceled'

Optional filter by task status.

project_idstring uuid nullable

Optional filter to tasks belonging to a single project.

Response

OK

next_pagestring nullable

Opaque cursor for the next page of task results. null when there are no more results.

request_idstring required

Identifier for this API request. Useful for tracing and support.

totalinteger required

Total number of matching tasks before pagination is applied.

Example response

{
  "next_page": null,
  "request_id": "api-request-018f8d0d-5a3c-7afc-8321-2f6f6e0fefab",
  "results": [
    {
      "created_at": "2026-04-27T10:00:00Z",
      "description": null,
      "due_at": "2026-05-15T17:00:00Z",
      "id": "5e29c8a2-c73b-476b-9311-e2579712d4b1",
      "project_id": null,
      "status": "pending",
      "title": "Send Q1 planning recap",
      "updated_at": "2026-04-27T10:00:00Z"
    }
  ],
  "total": 1
}

v2

List Tasks

Query parameters

Response

Example response