Skip to main content
Pinecone Docs

Search documentation

Type to search this documentation.

On this pageOverview

Get a task (with steps)

Unlike the listing, this carries the task's steps — every one by default, or the newest N with steps_limit, where steps_total reports the true count.

GET /tasks/{id}

  • id (path, string, required) — Task id.
  • 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.
  • steps_limit (query, integer) — Return only this many trailing steps. Absent returns them all.
  • 200 — The task
  • 404 — Not found
Suggest an edit

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

Export
Documentation menu