Describe a file upload

For guidance and examples, see Manage files.

PINECONE_API_KEY="YOUR_API_KEY"
ASSISTANT_NAME="example-assistant"
FILE_ID="3c90c3cc-0d44-4b50-8888-8dd25736052a"

# Describe a file. 
# To get a signed URL in the response, set `include_url` to `true`.
curl -X GET "https://prod-1-data.ke.pinecone.io/assistant/files/$ASSISTANT_NAME/$FILE_ID?include_url=true" \
  -H "Api-Key: $PINECONE_API_KEY" \
  -H "X-Pinecone-Api-Version: 2025-10"

GET /files/{assistant_name}/{assistant_file_id}

• X-Pinecone-Api-Version (header, string, required) — Required date-based version header
• assistant_name (path, string, required) — The name of the assistant to upload files to.
• assistant_file_id (path, string, required) — The uuid of the file to be described.
• include_url (query, string) — Include the signed URL of the file in the response.

• 200 — Poll request successful.
• 401 — Unauthorized. Possible causes: Invalid API key.
• 404 — File not found.
• 500 — Internal server error.