Describe an operation
Get the status of an operation.
PINECONE_API_KEY="YOUR_API_KEY"
ASSISTANT_NAME="example-assistant"
OPERATION_ID="op-1234-abcd-5678"
curl -X GET "https://prod-1-data.ke.pinecone.io/assistant/operations/$ASSISTANT_NAME/$OPERATION_ID" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "X-Pinecone-Api-Version: 2026-04"GET /operations/{assistant_name}/{operation_id}
{
"created_on": "2025-10-01T12:30:00.000Z",
"file_id": "my-report-2025",
"id": "op-1234-abcd-5678",
"operation_type": "upload_file",
"percent_complete": 42,
"status": "Processing"
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "Invalid API key."
},
"status": 401
}{
"error": {
"code": "NOT_FOUND",
"message": "Operation 1234-abcd-5678 not found."
},
"status": 404
}{
"error": {
"code": "UNKNOWN",
"message": "Internal server error"
},
"status": 500
}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.
operation_idstringrequiredThe identifier of the operation to be described.
Response
Section titled “Response”200 — Current information and status of the operation.
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