# List Operations

Monitor record-level errors across workflows in one organization. Filter by workflowId, createdOn, actionStatus, operation, stepId, or message; for example where=createdOn>=2026-11-01;actionStatus==error. Use where=message=like=*FAILED* for a substring match. Request limit up to 1000 and increase offset while meta.pagination.hasNextPage is true. Run metadata is null when its history is no longer retained. Operations for deleted workflows are excluded. When acting in another organization, Embedded runs and operations without retained run metadata are excluded.

`GET https://connect.mindcloud.co/v2/operations`

Permissions: `log:view`.

## Parameters

### Headers

- `X-Company-Id` (string): Optional. The id of the organization to act in. Leave it out to act in the API key's own organization. A key can also act in its child organizations, and, with "Use this key across all of your organizations" on, in every organization its creator can open in the app. List them with GET /v2/companies. Every response's X-Company-Id header names the organization it acted in. See [Organizations](https://mindcloud.co/docs/api/rest/introduction/organizations).

## Example request

```bash
curl --request GET \
  --url 'https://connect.mindcloud.co/v2/operations' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN'
```

## Response fields

- `id` (string): Unique id of the operation.
- `workflowLogId` (string): The run this operation happened in.
- `stepId` (string): The workflow step that performed it.
- `stepInstanceId` (string): The exact step execution that performed it.
- `actionId` (string): The action that ran.
- `appId` (string): The app that action belongs to.
- `model` (string): The kind of record that was touched.
- `operation` (string): What happened to the record: create, update, and so on.
- `actionStatus` (string): How it went, for example error.
- `primaryKey` (string): The touched record's primary key in the target system.
- `message` (string): What the platform logged about it.
- `createdOn` (date): When it happened.
- `workflowId` (string): The workflow this operation belongs to, from List Workflows.
- `runId` (string): The run this operation happened in, also returned as workflowLogId. Use Get Run for its details.
- `runStartedOn` (date): When the run started. Null if its run history is no longer retained.
- `runStatus` (string): The run status: waiting, running, finished, failed, cancelled, interrupted, limitExceeded, cancelling, or unknown. Null if its run history is no longer retained.
  Allowed values:
    - `waiting`
    - `running`
    - `finished`
    - `failed`
    - `cancelled`
    - `interrupted`
    - `limitExceeded`
    - `cancelling`
    - `unknown`
- `environmentId` (string): The environment the run targeted, from List Environments. Null if its run history is no longer retained or it has no environment.
- `environmentName` (string): The current name of the environment the run targeted. Null if the environment or run history is unavailable.
