# Inspect an organization actor and its lease history

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

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Operations & billing](https://everruns.com/docs/api/groups/operations-billing/)/Inspect an organization actor and its lease history

# Inspect an organization actor and its lease history

Preview

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

Public APIEverruns Cloud and self-hosted Platform

GET`/v1/monitoring/actors/{session_id}`

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

## Parameters

### Path Parameters

**session_id**

required

string

Session identifier

## Responses

200Organization actor diagnostics

### 200

Organization actor diagnostics

Media typeapplication/json

Authorized actor inspection with bounded ownership history and trace timing.

object

**actor**

required

Actor observation after validating the owning session’s organization.

object

**attempts_since_release**

Lease attempts accumulated since the last release.

integer | null format: int32

**cancel_requested_at**

UTC cancellation request timestamp; null when cancellation is not requested.

string | null format: date-time

**consumed_seq**

Persisted consumed event cursor; its difference from inbox_seq is not a pending-message count.

integer | null format: int64

**fence**

Monotonic ownership fence; null when no actor row exists.

integer | null format: int64

**holder**

Current recorded holder, or previous holder for an expired lease; null when unleased.

string | null

**inbox_seq**

Durable inbox progress cursor; it is not a message count.

integer | null format: int64

**lease_expires_at**

UTC deadline of the recorded lease; null when unleased.

string | null format: date-time

**lease_renewed_at**

Last persisted acquisition or renewal acknowledgement in UTC; null before an acknowledgement or after release.

string | null format: date-time

**lease_state**

required

Observed lease validity: held, expired, or unleased.

string

**lease_ttl_ms**

Positive interval between renewal acknowledgement and expiry in milliseconds; null when unavailable.

integer | null format: int64

**next_input_seq**

Persisted next-input progress cursor.

integer | null format: int64

**org_id**

required

Public identifier of the owning session’s organization.

string

**phase**

required

Observed execution state; idle is also possible for a released actor detail.

string

**phase_since**

required

UTC timestamp of the committed observation used to classify the phase.

string format: date-time

**runnable_age_ms**

Milliseconds awaiting a valid lease; null for held or parked actors.

integer | null format: int64

**runnable_since**

UTC timestamp when the actor became runnable; null for parked work.

string | null format: date-time

**session_id**

required

Canonical session identifier whose actor is being inspected.

string

**session_status**

required

Persisted session lifecycle status.

string

**generated_at**

required

UTC observation time for actor ownership and timing.

string format: date-time

**ownership_history**

required

Up to 50 newest ownership changes from the retained one-day history.

Array\<object>

Persisted actor ownership transition, excluding renewal noise.

object

**expires_at**

New lease deadline in UTC; null for a release.

string | null format: date-time

**fence**

required

Ownership fence associated with this transition.

integer format: int64

**holder**

required

Holder acquiring ownership, or the holder relinquishing a released lease.

string

**kind**

required

Ownership transition: acquired, reacquired, or released; renewals produce no history entry.

string

**occurred_at**

required

UTC time of the persisted ownership transition.

string format: date-time

**previous_expires_at**

Previous lease deadline in UTC, when recorded.

string | null format: date-time

**previous_holder**

Holder preceding acquisition or reacquisition, when recorded.

string | null

**steps**

required

Up to 100 projected steps from the latest turn, newest first; no conversation payloads.

Array\<object>

Payload-free timing projection of one step in the latest turn.

object

**duration_ms**

Recorded step duration in milliseconds; null until duration is available.

integer | null format: int64

**kind**

required

Trace-step category, without tool arguments, results, or agent names.

string

**started_at**

required

UTC time at which the projected step started.

string format: date-time

**status**

required

Projected execution status of the trace step.

string

**step_no**

required

Projected step ordinal within the turn.

integer format: int32

**turn_no**

required

Projected turn ordinal for this trace step.

integer format: int32

### Example

```json
{
  "actor": {
    "attempts_since_release": 1,
    "cancel_requested_at": "2026-10-14T12:00:02Z",
    "consumed_seq": 39,
    "fence": 17,
    "holder": "worker-01",
    "inbox_seq": 42,
    "lease_expires_at": "2026-10-14T12:00:10Z",
    "lease_renewed_at": "2026-10-14T12:00:00Z",
    "lease_state": "held",
    "lease_ttl_ms": 10000,
    "next_input_seq": 12,
    "org_id": "org_00000000000000000000000000000001",
    "phase": "model",
    "phase_since": "2026-10-14T12:00:01Z",
    "runnable_age_ms": 3000,
    "runnable_since": "2026-10-14T11:59:59Z",
    "session_id": "session_01933b5a000070008000000000000001",
    "session_status": "active"
  },
  "generated_at": "2026-10-14T12:00:03Z",
  "ownership_history": [
    {
      "expires_at": "2026-10-14T12:00:10Z",
      "fence": 18,
      "holder": "worker-02",
      "kind": "reacquired",
      "occurred_at": "2026-10-14T12:00:00Z",
      "previous_expires_at": "2026-10-14T11:59:59Z",
      "previous_holder": "worker-01"
    }
  ],
  "steps": [
    {
      "duration_ms": 820,
      "kind": "tool",
      "started_at": "2026-10-14T12:00:01Z",
      "status": "completed",
      "step_no": 3,
      "turn_no": 2
    }
  ]
}
```

404Actor not found

### 404

Actor not found

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/actors/example';
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/actors/example
```

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

200404

200 · Organization actor diagnostics

```json
{
  "actor": {
    "attempts_since_release": 1,
    "cancel_requested_at": "2026-10-14T12:00:02Z",
    "consumed_seq": 39,
    "fence": 17,
    "holder": "worker-01",
    "inbox_seq": 42,
    "lease_expires_at": "2026-10-14T12:00:10Z",
    "lease_renewed_at": "2026-10-14T12:00:00Z",
    "lease_state": "held",
    "lease_ttl_ms": 10000,
    "next_input_seq": 12,
    "org_id": "org_00000000000000000000000000000001",
    "phase": "model",
    "phase_since": "2026-10-14T12:00:01Z",
    "runnable_age_ms": 3000,
    "runnable_since": "2026-10-14T11:59:59Z",
    "session_id": "session_01933b5a000070008000000000000001",
    "session_status": "active"
  },
  "generated_at": "2026-10-14T12:00:03Z",
  "ownership_history": [
    {
      "expires_at": "2026-10-14T12:00:10Z",
      "fence": 18,
      "holder": "worker-02",
      "kind": "reacquired",
      "occurred_at": "2026-10-14T12:00:00Z",
      "previous_expires_at": "2026-10-14T11:59:59Z",
      "previous_holder": "worker-01"
    }
  ],
  "steps": [
    {
      "duration_ms": 820,
      "kind": "tool",
      "started_at": "2026-10-14T12:00:01Z",
      "status": "completed",
      "step_no": 3,
      "turn_no": 2
    }
  ]
}
```

404 · Actor not found

```json
{
  "title": "Actor not found",
  "status": 404
}
```

## Matching endpoints