Actions6
- Assistant Actions
- File Actions
- Context Snippet Actions
File → List Files
AI-generatedSummary
Retrieve a list of files associated with a specified Pinecone Assistant, optionally filtered by metadata.
Inputs
- Assistant Name (required) — Select the Pinecone Assistant to retrieve files from.
- Additional Fields — Optional filters to limit the listed files, including Metadata Filter (key-value pairs), Advanced Metadata Filter (JSON expression), and Source Tag for usage attribution.
Output shape
a list of file objects in JSON format
The output returns an array of files. If metadata filters are provided, results will be limited accordingly. Only one of Metadata Filter or Advanced Metadata Filter can be set at a time. Errors are thrown for invalid JSON in advanced filter or if both filters are set.
Examples
Example 1: List all files for a specific Pinecone Assistant without filtering.
Set Assistant Name to the desired assistant; leave Additional Fields empty.
Example 2: List files with metadata where 'year' is greater than 2023 using advanced filter.
Set Assistant Name, and in Additional Fields set Advanced Metadata Filter to JSON {"year": {"$gt": 2023}}.