---
title: "Read event handling state"
method: GET
path: "/v1/sandboxes/{id}/agent-events/{event_id}"
tags: ["Sandboxes"]
---

# Read event handling state

`GET /v1/sandboxes/{id}/agent-events/{event_id}`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/sandboxes/{id}/agent-events/{event_id}`
- Auth: HTTP bearer

Handled means the logical run durably completed. Dispatch and queue acknowledgement do not imply successful handling.

## Path parameters

- `id` string, required
- `event_id` string, required

## Query parameters

- `source` string, required

## Response `200`

Success

- AgentEvent
  - `source` string, required
  - `event_id` string, required
  - `run_id` string, required
  - `exec_id` string, required
  - `state` 'queued' | 'running' | 'blocked' | 'handled' | 'expired', required
  - `reason` string, required
  - `created_at` string, date-time, required
  - `expires_at` string, date-time, required

## Other responses

- `default`: Request refused

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)