Skip to main content
GET
List a task's working-directory files

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.

Query Parameters

offset
integer<int64>

Where the page starts. Source and knowledge listings echo it rather than applying it, since they return the whole directory in one page.

limit
integer<int64>

Maximum entries in the page. Source and knowledge listings echo it rather than applying it, since they return the whole directory in one page.

Response

Directory listing

A task's file listing. Which branch answers depends on whether the task's files are still live or already archived.

entries
object[]
required

The directory's immediate children.

total
integer<int64>
required

Entries in the directory.

offset
integer<int64>
required

Where this page starts.

limit
integer<int64>
required

Maximum entries in this page.

next_offset
integer<int64> | null
required

Null on the last page.