v6

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01485121699.8 KB

List Tasks

List tasks, optionally filtered by status, cell_id, and/or claim owner.

When limit or offset query params are provided the response is a paginated envelope ({tasks, total, limit, offset}). Without them, the legacy flat list is returned for backward compatibility, capped at _LIST_TASKS_HARD_CAP items and accompanied by a Deprecation header asking callers to pass explicit pagination.

Args: request: FastAPI request. status: If provided, only tasks with this status are returned. cell_id: If provided, only tasks in this cell are returned. tenant: Tenant scope override. claimed_by_session: If provided, only tasks claimed by this parent orchestrator session are returned. limit: Maximum number of tasks to return (max 500). Triggers paginated response when present. offset: Number of tasks to skip. Triggers paginated response when present.

Returns: Paginated response or plain list of TaskResponse dicts (capped at _LIST_TASKS_HARD_CAP).

get/tasks

Query parameters

statusstring nullable
cell_idstring nullable
tenantstring nullable
claimed_by_sessionstring nullable
parent_session_idstring nullable
limitinteger nullable
offsetinteger nullable

Response

Successful Response

{"stackTrail":"paths:/tasks:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}