Manage Store Files
Once files are uploaded to your Store, you can manage them using these core operations. All operations work with the file ID.
Retrieve Store File
Get detailed information about a specific file:
The response includes comprehensive file information including processing status, metadata, usage statistics, and error details if applicable.
For complete details on all file object properties, see Data Models.
List Store Files
View all files in your Store. The list operation uses cursor-based pagination:
Pagination Details: For complete information about cursor-based pagination including parameters, response format, and advanced usage patterns, see the Pagination Reference.
Metadata Filtering
Filter Store Files based on their metadata.
Complete Filtering Guide: For detailed information about filter operators, logical operations, data types, and advanced patterns, see Metadata Filtering.
Paginate and Filter Files
List all available files and filter them by status. This operation combines cursor-based pagination with the status filter to retrieve only the subsets of files you care about. For a complete explanation of cursor-based pagination options, see the Pagination Reference.
Delete Store File
Remove files from your Store:
Important: Deleting a file permanently removes:
- The original file from storage
- All generated chunks and embeddings
- Associated metadata and search indexes
- Processing history and logs