Manage Assistants
List Files
List all files in an assistant, with an option to filter files with metadata.
For guidance and examples, see Manage files.
get/files/{assistant_name}
Path parameters
assistant_namestring required
The name of the assistant to list files for.
Query parameters
filterstring json
Optional JSON-encoded metadata filter for files.
limitinteger
Limit on the number of files to return.
pagination_tokenstring
Pagination token to continue a previous listing operation.
Headers
X-Pinecone-Api-Versionstring required
Required date-based version header
Response
This operation returns a list of all files that you have previously uploaded, and which are associated with the given assistant name.
Example response
{
"files": [
{
"size": 1048576,
"metadata": {
"created_by": "Jane Doe",
"published": "2025-10-01T00:00:00.000Z",
"tags": [
"report",
"Q4",
"analytics"
]
},
"created_on": "2025-10-01T12:30:00.000Z",
"updated_on": "2025-10-01T12:45:00.000Z",
"signed_url": "https://storage.googleapis.com/bucket/file.pdf?..."
}
],
"pagination": {
"next": "dXNlcl9pZD11c2VyXzE="
}
}