List tasks
[!NOTE] This endpoint is in public preview and is subject to change.
Returns a list of tasks for the authenticated user
Fine-grained access tokens for "List tasks"
This endpoint works with the following fine-grained token types:
The fine-grained token must have the following permission set:
- "Agent tasks" repository permissions (read)
GitHub App installation access tokens are not supported for this endpoint.
Query parameters
The number of results per page (max 100).
The page number of the results to fetch.
The field to sort results by. Can be updated_at or created_at.
The direction to sort results. Can be asc or desc.
Comma-separated list of task states to filter by. Can be any combination of: queued, in_progress, completed, failed, idle, waiting_for_user, timed_out, cancelled.
Filter by archived status. When true, returns only archived tasks. When false or omitted, returns only non-archived tasks. Defaults to false.
Only show tasks updated at or after this time (ISO 8601 timestamp)
Response
Tasks retrieved successfully