Both successful and failed operations are retained for 30 days after completion.
Use the `operation_type` and `status` query parameters to filter results.

:::code-group
```bash curl
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}`

:::code-group
```json title="200"
{
  "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="
  }
}
```

```json title="401"
{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "Invalid API key."
  },
  "status": 401
}
```

```json title="404"
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Assistant \"example-assistant\" not found."
  },
  "status": 404
}
```

```json title="500"
{
  "error": {
    "code": "UNKNOWN",
    "message": "Internal server error"
  },
  "status": 500
}
```
:::

#### Authorizations

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `Api-Key` | `string` | - | Pinecone API Key |

#### Headers

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `X-Pinecone-Api-Version` | `string` | `2026-04` | Required date-based version header |

#### Path Parameters

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `assistant_name` | `string` | - | The name of the assistant to list operations for. |

#### Query Parameters

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `operation_type?` | `string` | - | Filter operations by type. |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `status?` | `string` | - | Filter operations by status. |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `limit?` | `integer` | - | Limit on the number of operations to return. Required range: 1 <= x <= 100 |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `pagination_token?` | `string` | - | Pagination token to continue a previous listing operation. |

#### Response

`200` — Successful response.

A list of operations.

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `operations?` | `object[]` | - | The list of operations for the assistant. |

:::accordion{title="Show child attributes"}
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `id` | `string` | - | The unique identifier for the operation. Example: op-1234-abcd-5678 |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `operation_type` | `string` | - | The kind of action represented by this operation, such as uploading or deleting a file. Example: upload_file |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `file_id?` | `string \| null` | - | The identifier of the file being operated on. Example: my-file-id-123 |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `status` | `string` | - | 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 |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `created_on` | `string` | - | The timestamp when the operation was created, in ISO 8601 format. Example: 2025-10-01T12:30:00.000Z |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `completed_on?` | `string \| 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 |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `percent_complete?` | `integer` | - | The progress made by the operation, as a percentage (0-100). Required range: 0 <= x <= 100. Example: 42 |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `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. |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `ingestion_units?` | `number \| null` | - | The number of ingestion units consumed by this operation. Present only when status is Completed for file ingestion operations. Example: 50 |
:::

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `pagination?` | `object` | - | Object that contains the next pagination token to continue a previous listing operation. |

:::accordion{title="Show child attributes"}
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `next` | `string` | - | The token to use to retrieve the next page of results. |
:::

## Related pages

- [Account management](./account-management-index.md)
- [Admin](./admin-2-index.md)
- [Admin](./admin-index.md)
- [APIs](./apis-index.md)
- [Architecture](./architecture-index.md)
- [Bring Your Own Cloud](./bring-your-own-cloud-index.md)
- [Build an assistant](./build-an-assistant-index.md)
- [Build an integration](./build-an-integration-index.md)
- [Changelog](./changelog-index.md)
- [Changelog](../changelog.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.