Skip to main content
GET
/
operations
/
{assistant_name}
/
{operation_id}
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"

{
  "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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.pinecone.io/llms.txt

Use this file to discover all available pages before exploring further.

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"
Operation responses may include error_message, but only when the operation status is Failed.

Authorizations

​
Api-Key
string
header
required

Pinecone API Key

Headers

​
X-Pinecone-Api-Version
string
default:2026-04
required

Required date-based version header

Path Parameters

​
assistant_name
string
required

The name of the assistant.

​
operation_id
string
required

The identifier of the operation to be described.

Response

Current information and status of the operation.

The OperationModel describes the status of an ongoing or completed server operation.

​
id
string
required

The unique identifier for the operation.

Example:

"op-1234-abcd-5678"

​
operation_type
string
required

The kind of action represented by this operation, such as uploading or deleting a file.

Example:

"upload_file"

​
status
string
required

The 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_on
string<date-time>
required

The timestamp when the operation was created, in ISO 8601 format.

Example:

"2025-10-01T12:30:00.000Z"

​
file_id
string | null

The identifier of the file being operated on.

Example:

"my-file-id-123"

​
completed_on
string<date-time> | null

The 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
integer<int32>

The progress made by the operation, as a percentage (0-100).

Required range: 0 <= x <= 100
Example:

42

​
error_message
string | null

A 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<double> | null

The number of ingestion units consumed by this operation. Present only when status is Completed for file ingestion operations.

Example:

50