List Follow Ups

List follow-ups 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, task_id, and project_id filters to narrow the result set.

limitinteger nullable

Maximum number of follow-ups 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, task_id, and project_id values.

Sort key for pagination boundaries. Use scheduled_for (default) for latest-scheduled-first follow-up feeds, scheduled_for_asc for soonest-scheduled-first pending sweeps, updated_at or updated_at_asc for recency/staleness feeds, and created_at or created_at_asc for creation-order views.

status'pending' | 'fired' | 'completed' | 'canceled'

Optional filter by follow-up status.

task_idstring uuid nullable

Optional filter to follow-ups associated with a single task.

project_idstring uuid nullable

Optional filter to follow-ups associated with a single project.

Response

OK

next_pagestring nullable

Opaque cursor for the next page of follow-up 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 follow-ups before pagination is applied.

v3

List Follow Ups

Query parameters

Response