Skip to main content
Pinecone Docs

Search documentation

Type to search this documentation.

On this pageOverview

List tasks (project-wide, paginated)

Task records across the project, newest first. Filter by workflow, state, or context, and page with limit plus page or offset.

GET /tasks

  • X-Pinecone-Api-Version (header, string) — Date-based contract version, echoed back on the same header. Omit for the default (2026-07); send unstable for the in-development surface. An unrecognized value is rejected with 400 unsupported_api_version.
  • workflow (query, string) — Return only tasks of this workflow.
  • state (query, string) — Return only tasks in this state.
  • context (query, string) — Context slug or UUID
  • q (query, string) — Free-text over id/created_by/input
  • limit (query, integer) — Maximum tasks per page.
  • page (query, integer) — 1-based page to return. Ignored when offset is given.
  • offset (query, integer) — Where the page starts. Takes precedence over page.
  • 200 — Paginated tasks
Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu