Skip to main content
Pinecone Docs

Search documentation

Type to search this documentation.

On this pageOverview

Stat a task file

Stat one file in the task container without reading its bytes.

GET /tasks/{id}/files/metadata/{path}

  • id (path, string, required) — Task id.
  • path (path, string, required) — Relative path within the tree. Matches greedily, so it may contain /.
  • 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.
  • 200 — File metadata — the archived or the live shape, depending on task state
  • 404 — Not found
Suggest an edit

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

Export
Documentation menu