Skip to main content
GET
/
tasks
List Tasks
curl --request GET \
  --url https://api.example.com/tasks

​
GET /tasks

Retrieve a paginated list of async tasks in the workspace. Use this to monitor queued jobs, review historical task outcomes, or build operational dashboards.

​
Notes

  • Supports filtering by status (pending, queued, running, completed, failed, cancelled) and task_type (energy_model, shading_scene_create, workflow, etc.).
  • Date range filtering is available via created_after and created_before query parameters (ISO 8601 format, e.g. 2026-03-01).
  • Pagination defaults to page=1 and page_size=50. Maximum page size is 1000.
  • Response includes tasks (array), total (count), page, and pageSize fields.
  • Read-only endpoint; does not require write access.
  • Use GET /tasks/ to fetch full details for a specific task.