# Get organization execution monitoring

Source: <https://everruns.com/docs/api/operations/get_monitoring/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Operations & billing](https://everruns.com/docs/api/groups/operations-billing/)/Get organization execution monitoring

# Get organization execution monitoring

Preview

Operate durable execution, schedules, sandbox infrastructure, budgets, payments and audit logs.

Public APIEverruns Cloud and self-hosted Platform

GET`/v1/monitoring`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Responses

200Organization execution monitoring

### 200

Organization execution monitoring

Media typeapplication/json

Live execution population, ownership, and event-window summary.

object

**actor_leases**

required

Complete count of actor leases valid at the observation time.

integer format: int64

**actors**

required

Complete population of live sessions and runnable or held session actors.

integer format: int64

**cohorts**

required

Bounded phase, organization, and live holder breakdown; consult cohorts_truncated.

Array\<object>

Bounded execution breakdown for one organization and live lease holder.

object

**count**

required

Sessions in this phase, organization, and holder cohort.

integer format: int64

**org_id**

required

Public identifier of the organization owning these sessions.

string

**phase**

required

Execution state shared by this organization and live holder cohort.

string

**worker_id**

Live lease holder; null for unleased or expired ownership.

string | null

**cohorts_truncated**

required

Whether ownership cohort detail exceeded its limit; population and phase counts remain complete.

boolean

**events**

required

Committed lifecycle event counts in the lookback window, not lifetime totals.

object

**_key_**

additional properties

integer format: int64

**expired_leases**

required

Held leases whose deadline has passed, regardless of worker heartbeat.

integer format: int64

**generated_at**

required

UTC observation time used to classify lease validity and event windows.

string format: date-time

**lease_events**

required

Acquisition, reacquisition, and release counts in the lookback window; renewals are excluded.

object

**_key_**

additional properties

integer format: int64

**oldest_runnable_ms**

Age of the oldest work awaiting a valid lease, in milliseconds; null when none is runnable.

integer | null format: int64

**organizations**

required

Distinct organizations represented in the current population.

integer format: int64

**ownership**

required

Organization-to-worker mapping derived only from valid actor leases.

Array\<object>

Valid actor ownership linking an organization to a worker.

object

**actor_leases**

required

Valid actor leases held by this worker within this organization.

integer format: int64

**org_id**

required

Public identifier of the sessions’ owning organization.

string

**worker_id**

required

Worker currently holding the valid actor leases.

string

**phases**

required

Complete counts by execution state, with observed phase ages.

Array\<object>

Population and age of one committed execution state.

object

**count**

required

Complete number of sessions observed in this execution state.

integer format: int64

**oldest_ms**

required

Age of the oldest committed phase observation in milliseconds; may be partial when cohorts are truncated.

integer format: int64

**phase**

required

Execution state: runnable, model, tools, waiting, or setup.

string

**scope**

required

Monitoring boundary: organization or fleet.

string

**window_seconds**

required

Lookback window for lifecycle and ownership event counts, in seconds.

integer format: int32

**workers**

required

Bounded worker observations; global telemetry is redacted for organization callers.

Array\<object>

Scope-aware actor ownership with platform-only worker telemetry.

object

**accepting_work**

Last reported admission flag; null in organization scope.

boolean | null

**actor_leases**

required

Valid actor leases in this monitoring scope; not occupied work slots.

integer format: int64

**capacity**

Reported maximum worker concurrency; null in organization scope.

integer | null format: int64

**current_load**

Reported worker activity load, distinct from actor leases; null in organization scope.

integer | null format: int64

**id**

required

Worker identifier recorded by actor ownership or the fleet registry.

string

**last_heartbeat_at**

Last worker heartbeat in UTC; null in organization scope.

string | null format: date-time

**phases**

required

Leased session counts by execution state within this scope.

object

**_key_**

additional properties

integer format: int64

**status**

Fleet-only worker status, including stale heartbeats; null in organization scope.

string | null

**worker_group**

Registered worker group; null in organization scope.

string | null

**workers_truncated**

required

Whether worker detail exceeded its limit; population and phase counts remain complete.

boolean

### Example

```json
{
  "actor_leases": 3700,
  "actors": 5000,
  "cohorts": [
    {
      "count": 32,
      "org_id": "org_00000000000000000000000000000001",
      "phase": "model",
      "worker_id": "worker-01"
    }
  ],
  "cohorts_truncated": false,
  "events": {
    "reason.started": 350,
    "tool.started": 240,
    "turn.started": 120
  },
  "expired_leases": 3,
  "generated_at": "2026-10-14T12:00:03Z",
  "lease_events": {
    "acquired": 120,
    "reacquired": 3,
    "released": 110
  },
  "oldest_runnable_ms": 3000,
  "organizations": 12,
  "ownership": [
    {
      "actor_leases": 32,
      "org_id": "org_00000000000000000000000000000001",
      "worker_id": "worker-01"
    }
  ],
  "phases": [
    {
      "count": 2800,
      "oldest_ms": 3200,
      "phase": "model"
    }
  ],
  "scope": "fleet",
  "window_seconds": 60,
  "workers": [
    {
      "accepting_work": true,
      "actor_leases": 32,
      "capacity": 50,
      "current_load": 8,
      "id": "worker-01",
      "last_heartbeat_at": "2026-10-14T12:00:00Z",
      "phases": {
        "model": 20,
        "tools": 12
      },
      "status": "active",
      "worker_group": "execution"
    }
  ],
  "workers_truncated": false
}
```

403Forbidden

### 403

Forbidden

Media typeapplication/json

Standard error response.

Wire shape is [RFC 9457 Problem Details](https://www.rfc-editor.org/rfc/rfc9457): every error response includes `title` and `status`, and may include `detail`, `code`, `allowed_actions`, `retry_after_seconds`, `instance`, and `type`. The content type is rewritten to `application/problem+json` with the `application/problem+json` content type.

object

**allowed_actions**

Recovery actions the caller can take next.

Array\<object>

Agent-actionable link describing a follow-up the caller can take. Used in two contexts:

* **Error recovery** — `ErrorResponse.allowed_actions` carries `rel`s like `retry`, `retry-later`, `unarchive`, `get-existing` so the agent knows the right next call after a 4xx/429.
* **Entity hypermedia** — `WithUrls<T>.allowed_actions` carries state-aware `rel`s like `cancel`, `events`, `self`, `update` on the entity itself so the agent can follow links instead of reconstructing routes from prose.

The shape is intentionally identical across both contexts; the closed `rel` vocabulary distinguishes them.

object

**hint**

Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”, “Cancel the active turn for this session.”).

string | null

**href**

Absolute (preferred) or relative URL the caller may invoke directly. **Always present on entity hypermedia actions** (`WithUrls<T>.allowed_actions`); **optional on error-recovery actions** (`ErrorResponse.allowed_actions`) where the matching `operation_id` is enough and the URI is implicit from the failed call.

string | null

**method**

HTTP method to use against `href`. Required for entity hypermedia actions; usually omitted on error-recovery actions where the same operation is retried with its original method.

string | null

**operation_id**

OpenAPI `operationId` the caller should invoke. Lets an MCP client resolve the call without parsing `href`.

string | null

**rel**

required

Link relation describing the action. Examples: `self`, `cancel`, `pause`, `resume`, `events`, `retry`, `retry-later`, `unarchive`, `get-existing`, `delete`, `update`.

string

**schema_ref**

OpenAPI `$ref` to the request-body schema, when the action takes one (e.g. `#/components/schemas/UpdateSessionRequest`). Lets a tool-calling agent fetch the input shape without scanning the whole spec.

string | null

**code**

Stable, machine-readable error code (snake_case).

string | null

**detail**

Human-readable explanation specific to this occurrence.

string | null

**instance**

Request URI for this occurrence.

string | null

**retry_after_seconds**

Seconds the caller should wait before retrying (429 / transient 503).

integer | null format: int32

**status**

required

HTTP status code; mirrors the response status line.

integer format: int32

**title**

required

Short, human-readable summary of the problem (e.g. “Not Found”).

string

**type**

RFC 9457 problem type URI. Optional; identifies the problem class.

string | null

### Example

```json
{
  "allowed_actions": [
    {
      "method": "POST"
    }
  ],
  "code": "session_not_found",
  "detail": "Session session_01933b5a000070008000000000000001 not found in org org_01933b5a000070008000000000000001.",
  "instance": "/v1/sessions/session_01933b5a000070008000000000000001",
  "retry_after_seconds": 30,
  "status": 404,
  "title": "Session not found",
  "type": "https://everruns.com/docs/errors/session_not_found"
}
```

404Not enrolled

### 404

Not enrolled

Media typeapplication/json

Standard error response.

Wire shape is [RFC 9457 Problem Details](https://www.rfc-editor.org/rfc/rfc9457): every error response includes `title` and `status`, and may include `detail`, `code`, `allowed_actions`, `retry_after_seconds`, `instance`, and `type`. The content type is rewritten to `application/problem+json` with the `application/problem+json` content type.

object

**allowed_actions**

Recovery actions the caller can take next.

Array\<object>

Agent-actionable link describing a follow-up the caller can take. Used in two contexts:

* **Error recovery** — `ErrorResponse.allowed_actions` carries `rel`s like `retry`, `retry-later`, `unarchive`, `get-existing` so the agent knows the right next call after a 4xx/429.
* **Entity hypermedia** — `WithUrls<T>.allowed_actions` carries state-aware `rel`s like `cancel`, `events`, `self`, `update` on the entity itself so the agent can follow links instead of reconstructing routes from prose.

The shape is intentionally identical across both contexts; the closed `rel` vocabulary distinguishes them.

object

**hint**

Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”, “Cancel the active turn for this session.”).

string | null

**href**

Absolute (preferred) or relative URL the caller may invoke directly. **Always present on entity hypermedia actions** (`WithUrls<T>.allowed_actions`); **optional on error-recovery actions** (`ErrorResponse.allowed_actions`) where the matching `operation_id` is enough and the URI is implicit from the failed call.

string | null

**method**

HTTP method to use against `href`. Required for entity hypermedia actions; usually omitted on error-recovery actions where the same operation is retried with its original method.

string | null

**operation_id**

OpenAPI `operationId` the caller should invoke. Lets an MCP client resolve the call without parsing `href`.

string | null

**rel**

required

Link relation describing the action. Examples: `self`, `cancel`, `pause`, `resume`, `events`, `retry`, `retry-later`, `unarchive`, `get-existing`, `delete`, `update`.

string

**schema_ref**

OpenAPI `$ref` to the request-body schema, when the action takes one (e.g. `#/components/schemas/UpdateSessionRequest`). Lets a tool-calling agent fetch the input shape without scanning the whole spec.

string | null

**code**

Stable, machine-readable error code (snake_case).

string | null

**detail**

Human-readable explanation specific to this occurrence.

string | null

**instance**

Request URI for this occurrence.

string | null

**retry_after_seconds**

Seconds the caller should wait before retrying (429 / transient 503).

integer | null format: int32

**status**

required

HTTP status code; mirrors the response status line.

integer format: int32

**title**

required

Short, human-readable summary of the problem (e.g. “Not Found”).

string

**type**

RFC 9457 problem type URI. Optional; identifies the problem class.

string | null

### Example

```json
{
  "allowed_actions": [
    {
      "method": "POST"
    }
  ],
  "code": "session_not_found",
  "detail": "Session session_01933b5a000070008000000000000001 not found in org org_01933b5a000070008000000000000001.",
  "instance": "/v1/sessions/session_01933b5a000070008000000000000001",
  "retry_after_seconds": 30,
  "status": 404,
  "title": "Session not found",
  "type": "https://everruns.com/docs/errors/session_not_found"
}
```

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/monitoring';
const options = {method: 'GET'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request GET \
  --url https://app.everruns.com/api/v1/monitoring
```

Additional language examples require JavaScript. The default request example is available above.

200403404

200 · Organization execution monitoring

```json
{
  "actor_leases": 3700,
  "actors": 5000,
  "cohorts": [
    {
      "count": 32,
      "org_id": "org_00000000000000000000000000000001",
      "phase": "model",
      "worker_id": "worker-01"
    }
  ],
  "cohorts_truncated": false,
  "events": {
    "reason.started": 350,
    "tool.started": 240,
    "turn.started": 120
  },
  "expired_leases": 3,
  "generated_at": "2026-10-14T12:00:03Z",
  "lease_events": {
    "acquired": 120,
    "reacquired": 3,
    "released": 110
  },
  "oldest_runnable_ms": 3000,
  "organizations": 12,
  "ownership": [
    {
      "actor_leases": 32,
      "org_id": "org_00000000000000000000000000000001",
      "worker_id": "worker-01"
    }
  ],
  "phases": [
    {
      "count": 2800,
      "oldest_ms": 3200,
      "phase": "model"
    }
  ],
  "scope": "fleet",
  "window_seconds": 60,
  "workers": [
    {
      "accepting_work": true,
      "actor_leases": 32,
      "capacity": 50,
      "current_load": 8,
      "id": "worker-01",
      "last_heartbeat_at": "2026-10-14T12:00:00Z",
      "phases": {
        "model": 20,
        "tools": 12
      },
      "status": "active",
      "worker_group": "execution"
    }
  ],
  "workers_truncated": false
}
```

403 · Forbidden

```json
{
  "title": "Forbidden",
  "status": 403
}
```

404 · Not enrolled

```json
{
  "title": "Not enrolled",
  "status": 404
}
```

## Matching endpoints