Delete a file
Delete an uploaded file from an assistant.
This operation is asynchronous. The response includes an operation ID that can be used to poll for completion via the describe operation endpoint.
PINECONE_API_KEY="YOUR_API_KEY"
ASSISTANT_NAME="example-assistant"
FILE_ID="070513b3-022f-4966-b583-a9b12e0290ff"
curl -X DELETE "https://prod-1-data.ke.pinecone.io/assistant/files/$ASSISTANT_NAME/$FILE_ID" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "X-Pinecone-Api-Version: 2026-04"{
"id": "op-7777-ffff-0000",
"operation_type": "delete_file",
"file_id": "my-file-id-123",
"status": "Processing",
"created_on": "2025-10-01T12:30:00Z",
"percent_complete": 0
}DELETE /files/{assistant_name}/{assistant_file_id}
Authorizations
Section titled “Authorizations”Api-KeystringrequiredPinecone API Key
Headers
Section titled “Headers”X-Pinecone-Api-VersionstringrequiredRequired date-based version header
Path Parameters
Section titled “Path Parameters”assistant_namestringrequiredThe name of the assistant that contains the file.
assistant_file_idstringrequiredThe identifier of the file to be deleted.
Response
Section titled “Response”202 — The request to delete the file has been accepted. The deletion will be processed asynchronously.
Describes the status of an ongoing or completed server operation.
idstringrequiredThe unique identifier for the operation.
Example: op-1234-abcd-5678
operation_typestringrequiredThe kind of action represented by this operation, such as uploading or deleting a file.
Example: upload_file
file_id?string | nullThe identifier of the file being operated on.
Example: my-file-id-123
statusstringrequiredThe status of the operation. - Processing: The operation is in progress. - Completed: The operation finished successfully. - Failed: The operation failed. See error_message for details.
Example: Processing
created_onstringrequiredThe timestamp when the operation was created, in ISO 8601 format.
Example: 2025-10-01T12:30:00.000Z
completed_on?string | nullThe timestamp when the operation completed or failed, in ISO 8601 format. Present only when status is Completed or Failed.
Example: 2025-10-01T12:35:00.000Z
percent_complete?integerThe progress made by the operation, as a percentage (0-100).
Required range: 0 <= x <= 100. Example: 42
error_message?string | nullA message describing the error that caused the operation to fail. Present only when status is Failed.
Example: File processing failed: unsupported file format.
ingestion_units?number | nullThe number of ingestion units consumed by this operation. Present only when status is Completed for file ingestion operations.
Example: 50