# Get recorded execution history across all organizations

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

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Operations & billing](https://everruns.com/docs/api/groups/operations-billing/)/Get recorded execution history across all organizations

# Get recorded execution history across all organizations

Preview

Get recorded execution history across all organizations. Requires platform-user access.

Internal operator APIEverruns Cloud and self-hosted Platform

GET`/v1/durable/monitoring/timeline`

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

## Parameters

### Query Parameters

**range**

string

Range ending now: 15m, 1h, 6h, 24h, 7d, or 30d. Ignored when `from` is set. Defaults to 24h.

#### Example

```plaintext
24h
```

**from**

string format: date-time

Inclusive UTC start; use with `to` for a custom range of up to 31 days.

**to**

string format: date-time

Exclusive UTC end; defaults to now.

**bucket**

integer format: int64

Bucket size in seconds: 60, 300, 900, 3600, 21600, or 86400. Chosen from the range when omitted.

#### Example

```json
300
```

## Responses

200Platform execution history

### 200

Platform execution history

Media typeapplication/json

Recorded execution history for one organization or the platform.

object

**agents_now**

required

Agents defined right now.

integer format: int64

**bucket_seconds**

required

Bucket size in seconds.

integer format: int32

**buckets**

required

Every bucket in the range, oldest first; buckets without history are zero.

Array\<object>

One time bucket. Averages are over 10-second samples; counters are exact.

object

**active_avg**

required

Average sessions with an active, runnable, or held actor.

number format: double

**active_peak**

required

Highest sampled count of such sessions.

integer format: int64

**agents**

Agents defined, not archived: the newest count in or before the bucket.

integer | null format: int64

**agents_working_avg**

required

Average distinct agents with an active session on workers.

number format: double

**agents_working_peak**

required

Highest sampled count of such agents.

integer format: int64

**backfilled**

required

Whether this bucket includes history rebuilt from turn records (no phase split or queue data).

boolean

**cost_usd**

required

Model spend in USD, actual where reconciled, otherwise estimated.

number format: double

**input_tokens**

required

Model input tokens.

integer format: int64

**lease_takeovers**

required

Expired leases another worker took over.

integer format: int64

**leases_peak**

required

Highest sampled count of valid actor leases.

integer format: int64

**model_avg**

required

Average sessions in a model phase.

number format: double

**model_calls**

required

Model calls started.

integer format: int64

**model_latency_p95_ms**

Highest per-minute p95 model call duration in the bucket, in milliseconds.

integer | null format: int64

**oldest_runnable_ms**

Longest wait for a worker lease observed in the bucket, in milliseconds.

integer | null format: int64

**open_sessions**

Sessions not archived, on any data plane: the newest count in or before the bucket.

integer | null format: int64

**organizations_peak**

Platform only: highest number of organizations with active sessions at once.

integer | null format: int64

**output_tokens**

required

Model output tokens.

integer format: int64

**runnable_avg**

required

Average sessions ready and waiting for a worker lease.

number format: double

**runnable_peak**

required

Highest sampled count of sessions waiting for a worker.

integer format: int64

**sampled**

required

Whether population was sampled; false for empty buckets and history rebuilt from turn records.

boolean

**servers**

Platform only: server replicas running.

integer | null format: int64

**setup_avg**

required

Average sessions in turn setup or a phase handoff.

number format: double

**shards**

One of:

* object

  Data plane v2 shards; absent when no shard reported and no shard turn finished in the bucket.

  object

  **admit_p99_ms**

  Platform only: worst node’s p99 time to admit a turn, in milliseconds.

  integer | null format: int64

  **agents_working_avg**

  required

  Average distinct agents with a running turn on shards.

  number format: double

  **agents_working_peak**

  required

  Highest per-minute agents with a running turn on shards.

  integer format: int64

  **cost_usd**

  required

  Model spend on shards in USD.

  number format: double

  **cpu_peak_pct**

  Platform only: the busiest node’s CPU use as a percentage of its limit.

  number | null format: double

  **elections**

  Platform only: leader elections across shards.

  integer | null format: int64

  **input_tokens**

  required

  Model input tokens on shards.

  integer format: int64

  **memory_peak_pct**

  Platform only: the fullest node’s memory use as a percentage of its limit.

  number | null format: double

  **model_calls**

  required

  Model calls made on shards.

  integer format: int64

  **moves**

  Platform only: sessions moved to another shard.

  integer | null format: int64

  **nodes**

  Platform only: highest total of shard nodes (pods) in one minute.

  integer | null format: int64

  **nodes_answering**

  Platform only: lowest total of nodes that answered their leader in one minute.

  integer | null format: int64

  **output_tokens**

  required

  Model output tokens on shards.

  integer format: int64

  **queued_peak**

  required

  Highest per-minute messages waiting for a turn on shards.

  integer format: int64

  **reporting**

  required

  Highest number of shards that reported in one minute.

  integer format: int64

  **resumed_peak**

  Platform only: highest per-minute turns running on a second or later attempt.

  integer | null format: int64

  **running_avg**

  required

  Average turns running on shards.

  number format: double

  **running_peak**

  required

  Highest per-minute turns running on shards.

  integer format: int64

  **sessions_avg**

  required

  Average sessions resident on shards.

  number format: double

  **sessions_peak**

  required

  Highest per-minute sessions resident on shards.

  integer format: int64

  **ship_lag_p99_ms**

  Platform only: worst node’s p99 log shipping lag, in milliseconds.

  integer | null format: int64

  **turns_cancelled**

  required

  Turns cancelled on shards.

  integer format: int64

  **turns_completed**

  required

  Turns completed on shards.

  integer format: int64

  **turns_failed**

  required

  Turns failed on shards.

  integer format: int64

* null

  null

**start**

required

UTC start of the bucket.

string format: date-time

**tool_calls**

required

Tool calls started.

integer format: int64

**tool_failures**

required

Tool calls that ended in an error or timeout.

integer format: int64

**tools_avg**

required

Average sessions running tools.

number format: double

**turns_cancelled**

required

Turns cancelled.

integer format: int64

**turns_completed**

required

Turns completed.

integer format: int64

**turns_failed**

required

Turns failed.

integer format: int64

**turns_started**

required

Turns started.

integer format: int64

**waiting_avg**

required

Average sessions waiting for input or external tool results.

number format: double

**worker_capacity**

Platform only: total worker slots.

integer | null format: int64

**worker_load_avg**

Platform only: average reported worker load across all workers.

number | null format: double

**worker_load_peak**

Platform only: highest reported total worker load.

integer | null format: int64

**worker_loads**

required

Platform only: per-worker average load.

Array\<object>

Load of one worker over a bucket (platform scope).

object

**capacity**

required

Reported maximum concurrency.

integer format: int64

**load_avg**

required

Average reported load over the bucket’s samples.

number format: double

**worker_id**

required

Worker identifier from the registry.

string

**workers**

Platform only: registered workers with a fresh heartbeat.

integer | null format: int64

**from**

required

Inclusive UTC start, aligned to the bucket size.

string format: date-time

**generated_at**

required

UTC time of this read.

string format: date-time

**markers**

required

Deploys, worker changes and shard leader changes inside the range.

Array\<object>

Deploy or worker change on the timeline.

object

**at**

required

UTC time of the change.

string format: date-time

**kind**

required

Deploy, worker_joined, worker_left, or leader_change (all but deploy are platform only).

string

**label**

required

Server version for a deploy, worker id or shard name otherwise.

string

**open_sessions_now**

required

Sessions not archived right now, on any data plane.

integer format: int64

**previous**

required

Totals for the same length of time immediately before.

object

**cost_usd**

required

Model spend in USD.

number format: double

**failure_rate**

Failed turns divided by finished turns; null when none finished.

number | null format: double

**longest_wait_at**

Start of the bucket with the longest wait.

string | null format: date-time

**longest_wait_ms**

Longest wait for a worker lease, in milliseconds.

integer | null format: int64

**peak_active**

required

Highest sampled parallel sessions.

integer format: int64

**peak_at**

Minute of that peak.

string | null format: date-time

**seconds_above_90**

Platform only: seconds of buckets whose peak load exceeded 90% of capacity.

integer | null format: int64

**shards_elections**

Platform only: leader elections across shards; null when no shard reported.

integer | null format: int64

**shards_peak_running**

Highest per-minute turns running on shards; null when no shard reported.

integer | null format: int64

**tool_calls**

required

Tool calls started.

integer format: int64

**turns_failed**

required

Turns failed.

integer format: int64

**turns_finished**

required

Turns that finished: completed, failed, or cancelled.

integer format: int64

**turns_started**

required

Turns started.

integer format: int64

**scope**

required

Organization or fleet.

string

**summary**

required

Totals for this range.

object

**cost_usd**

required

Model spend in USD.

number format: double

**failure_rate**

Failed turns divided by finished turns; null when none finished.

number | null format: double

**longest_wait_at**

Start of the bucket with the longest wait.

string | null format: date-time

**longest_wait_ms**

Longest wait for a worker lease, in milliseconds.

integer | null format: int64

**peak_active**

required

Highest sampled parallel sessions.

integer format: int64

**peak_at**

Minute of that peak.

string | null format: date-time

**seconds_above_90**

Platform only: seconds of buckets whose peak load exceeded 90% of capacity.

integer | null format: int64

**shards_elections**

Platform only: leader elections across shards; null when no shard reported.

integer | null format: int64

**shards_peak_running**

Highest per-minute turns running on shards; null when no shard reported.

integer | null format: int64

**tool_calls**

required

Tool calls started.

integer format: int64

**turns_failed**

required

Turns failed.

integer format: int64

**turns_finished**

required

Turns that finished: completed, failed, or cancelled.

integer format: int64

**turns_started**

required

Turns started.

integer format: int64

**to**

required

Exclusive UTC end.

string format: date-time

### Example

```json
{
  "bucket_seconds": 300,
  "buckets": [
    {
      "active_avg": 96.4,
      "active_peak": 112,
      "cost_usd": 0.29,
      "shards": {
        "reporting": 12
      },
      "start": "2026-11-01T05:00:00Z",
      "worker_loads": [
        {
          "capacity": 50,
          "load_avg": 31.5,
          "worker_id": "worker-01"
        }
      ]
    }
  ],
  "markers": [
    {
      "kind": "deploy",
      "label": "0.50.1"
    }
  ],
  "scope": "organization"
}
```

400Invalid range

### 400

Invalid range

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"
}
```

403Platform access required

### 403

Platform access required

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/durable/monitoring/timeline?range=24h&bucket=300';
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/durable/monitoring/timeline?range=24h&bucket=300'
```

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

200400403

200 · Platform execution history

```json
{
  "agents_now": 0,
  "bucket_seconds": 300,
  "buckets": [
    {
      "active_avg": 96.4,
      "active_peak": 112,
      "agents_working_avg": 0,
      "agents_working_peak": 0,
      "backfilled": true,
      "cost_usd": 0.29,
      "input_tokens": 0,
      "lease_takeovers": 0,
      "leases_peak": 0,
      "model_avg": 0,
      "model_calls": 0,
      "output_tokens": 0,
      "runnable_avg": 0,
      "runnable_peak": 0,
      "sampled": true,
      "setup_avg": 0,
      "start": "2026-11-01T05:00:00Z",
      "tool_calls": 0,
      "tool_failures": 0,
      "tools_avg": 0,
      "turns_cancelled": 0,
      "turns_completed": 0,
      "turns_failed": 0,
      "turns_started": 0,
      "waiting_avg": 0,
      "worker_loads": []
    }
  ],
  "from": "2026-10-12T09:00:00Z",
  "generated_at": "2026-10-12T09:00:00Z",
  "markers": [
    {
      "at": "2026-10-12T09:00:00Z",
      "kind": "deploy",
      "label": "0.50.1"
    }
  ],
  "open_sessions_now": 0,
  "previous": {
    "cost_usd": 0,
    "peak_active": 0,
    "tool_calls": 0,
    "turns_failed": 0,
    "turns_finished": 0,
    "turns_started": 0
  },
  "scope": "organization",
  "summary": {
    "cost_usd": 0,
    "peak_active": 0,
    "tool_calls": 0,
    "turns_failed": 0,
    "turns_finished": 0,
    "turns_started": 0
  },
  "to": "2026-10-12T09:00:00Z"
}
```

400 · Invalid range

```json
{
  "title": "Invalid range",
  "status": 400
}
```

403 · Platform access required

```json
{
  "title": "Platform access required",
  "status": 403
}
```

## Matching endpoints