v1

latestOpenAPI 3.0.3Apache 2.02026-07-1372170520.1 KB
Manage Assistants

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.

get/operations/{assistant_name}

Path parameters

assistant_namestring required

The name of the assistant to list operations for.

Query parameters

operation_typestring

Filter operations by type.

statusstring

Filter operations by status.

limitinteger

Limit on the number of operations to return.

pagination_tokenstring

Pagination token to continue a previous listing operation.

Headers

X-Pinecone-Api-Versionstring required

Required date-based version header

Response

A list of operations.

Example response

{
  "operations": [
    {
      "id": "op-1234-abcd-5678",
      "operation_type": "upload_file",
      "file_id": "my-file-id-123",
      "status": "Processing",
      "created_on": "2025-10-01T12:30:00Z",
      "completed_on": "2025-10-01T12:35:00Z",
      "percent_complete": 42,
      "error_message": "File processing failed: unsupported file format.",
      "ingestion_units": 50
    }
  ],
  "pagination": {
    "next": "dXNlcl9pZD11c2VyXzE="
  }
}