---
title: "List Ops"
method: GET
path: "/infra/operations/"
tags: ["infra-operations"]
---

# List Ops

`GET /infra/operations/`

## Request

- Base URL: `https://api.4chems.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.4chems.com/infra/operations/`
- Auth: HTTP bearer

List async operations across every tier, optionally filtered by status, type,
tenant, or actor. Call this when an operator needs to triage the infra operations
queue, e.g. to find stuck or failed operations to retry or cancel.

## Query parameters

- `status` 'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled'
- `type` string, nullable
- `tier` 'ops' | 'infra' | 'v1'
- `tenant` string, nullable
- `actor_sub` string, nullable
- `created_before` string, date-time, nullable
- `created_after` string, date-time, nullable
- `stuck` boolean
- `offset` integer
- `limit` integer

## Response `200`

Successful Response

- OperationListOut
  - `items` OperationInfraOut[], required
    - `operation_id` string, uuid, required
    - `status` string, required
    - `type` string, required
    - `tier` string, required
    - `tenant` string, nullable
    - `actor_sub` string, required
    - `target_type` string, nullable
    - `target_id` string, nullable
    - `result` unknown
    - `error` ErrorDetail
      - `code` string, required
      - `message` string, required
    - `attempts` integer, required
    - `max_attempts` integer, required
    - `cancel_requested` boolean, required
    - `retried_by` string, nullable
    - `cancelled_by` string, nullable
    - `locked_until` string, date-time, nullable
    - `created_at` string, date-time, required
    - `started_at` string, date-time, nullable
    - `finished_at` string, date-time, nullable
  - `total` integer, required
  - `offset` integer, required
  - `limit` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/4chems/apis/platform-api.md) · [All operations](https://skmtc.dev/4chems/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/4chems/apis/platform-api/revisions/65e4f7b4dba0?raw)