Skip to main content
GET
Stat a task file

Authorizations

Authorization
string
header
required

Session token from POST /auth/login, sent as Authorization: Bearer <token>.

Headers

X-Pinecone-Api-Version
string
default:2026-07

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.

Path Parameters

id
string
required

Task id.

path
string
required

Relative path within the tree. Matches greedily, so it may contain /.

Response

File metadata — the archived or the live shape, depending on task state

A stat on one task file — the archived or the live shape, depending on whether the task still has a container.

is_dir
boolean
required

Whether the object is a directory.

is_file
boolean
required

Whether the object is a regular file.

size
integer<int64>
required

Byte size.

modified
integer<int64> | null
required

Unix seconds. Null when the store reports none.