List operations
List all operations for an assistant. Returns operations that are in progress, as well as recently completed or failed operations.
Both successful and failed operations are retained for 30 days after completion.
Use the operation_type and status query parameters to filter results.
PINECONE_API_KEY="YOUR_API_KEY"
ASSISTANT_NAME="example-assistant"
# List all operations
curl -X GET "https://prod-1-data.ke.pinecone.io/assistant/operations/$ASSISTANT_NAME" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "X-Pinecone-Api-Version: 2026-04"
# Filter by status
# curl -X GET "https://prod-1-data.ke.pinecone.io/assistant/operations/$ASSISTANT_NAME?status=Processing" \
# -H "Api-Key: $PINECONE_API_KEY" \
# -H "X-Pinecone-Api-Version: 2026-04"GET /operations/{assistant_name}
{
"operations": [
{
"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"
},
{
"completed_on": "2025-10-01T12:05:00.000Z",
"created_on": "2025-10-01T12:00:00.000Z",
"file_id": "quarterly-analysis",
"id": "op-8765-dcba-4321",
"operation_type": "upload_file",
"percent_complete": 100,
"status": "Completed"
},
{
"completed_on": "2025-10-01T11:32:00.000Z",
"created_on": "2025-10-01T11:30:00.000Z",
"error_message": "File processing failed: unsupported file format.",
"file_id": "invalid-file",
"id": "op-5555-eeee-9999",
"operation_type": "upload_file",
"percent_complete": 15,
"status": "Failed"
},
{
"completed_on": "2025-10-01T11:02:00.000Z",
"created_on": "2025-10-01T11:00:00.000Z",
"file_id": "old-report",
"id": "op-7777-ffff-0000",
"operation_type": "delete_file",
"percent_complete": 100,
"status": "Completed"
}
],
"pagination": {
"next": "dXNlcl9pZD11c2VyXzE="
}
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "Invalid API key."
},
"status": 401
}{
"error": {
"code": "NOT_FOUND",
"message": "Assistant \"example-assistant\" 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 to list operations for.
Query Parameters
Section titled “Query Parameters”operation_type?stringFilter operations by type.
status?stringFilter operations by status.
limit?integerLimit on the number of operations to return.
Required range: 1 <= x <= 100
pagination_token?stringPagination token to continue a previous listing operation.
Response
Section titled “Response”200 — Successful response.
A list of operations.
operations?object[]The list of operations for the assistant.
Show child attributes
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
pagination?objectObject that contains the next pagination token to continue a previous listing operation.
Show child attributes
nextstringrequiredThe token to use to retrieve the next page of results.