---
title: "List operations"
method: GET
path: "/operations/{assistant_name}"
tags: ["Manage Assistants"]
---

# List operations

`GET /operations/{assistant_name}`

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.

## Path parameters

- `assistant_name` string, required

## Query parameters

- `operation_type` string
- `status` string
- `limit` integer
- `pagination_token` string

## Headers

- `X-Pinecone-Api-Version` string, required

## Response `200`

A list of operations.

- AssistantDataOperationList — A list of operations.
  - `operations` AssistantDataOperationModel[] — The list of operations for the assistant.
    - `id` string, required — The unique identifier for the operation.
    - `operation_type` string, required — The kind of action represented by this operation, such as uploading or deleting a file.
    - `file_id` string, nullable — The identifier of the file being operated on.
    - `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.
    - `created_on` string, date-time, required — The timestamp when the operation was created, in ISO 8601 format.
    - `completed_on` string, date-time, nullable — The timestamp when the operation completed or failed, in ISO 8601 format. Present only when status is `Completed` or `Failed`.
    - `percent_complete` integer — The progress made by the operation, as a percentage (0-100).
    - `error_message` string, nullable — A message describing the error that caused the operation to fail. Present only when status is `Failed`.
    - `ingestion_units` number, double, nullable — The number of ingestion units consumed by this operation. Present only when status is `Completed` for file ingestion operations.
  - `pagination` AssistantDataPaginationResponse — Object that contains the next pagination token to continue a previous listing operation.
    - `next` string, required — The token to use to retrieve the next page of results.

## Other responses

- `401` — Unauthorized. Possible causes: Invalid API key.
- `404` — Assistant not found.
- `500` — Internal server error.

---

[API](https://skmtc.net/pinecone/apis/pinecone-api.md) · [All operations](https://skmtc.net/pinecone/apis/pinecone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinecone/pinecone-api/versions/35876583485d/schema)