---
title: "Lifecycle events of your sandboxes, snapshots and volumes, newest first."
method: GET
path: "/v1/events"
tags: ["observability"]
---

# Lifecycle events of your sandboxes, snapshots and volumes, newest first.

`GET /v1/events`

## Request

- Base URL: `https://api.withruntime.com`
- URL: `https://api.withruntime.com/v1/events`
- Auth: HTTP bearer

What webhooks deliver, to read instead: sandbox.created, sandbox.running, sandbox.paused, sandbox.woken, sandbox.stopped, sandbox.start_failed, sandbox.wake_failed, sandbox.host_unreachable, sandbox.host_reachable, sandbox.recovered, sandbox.recovery_failed, sandbox.files.changed, sandbox.out_of_memory, sandbox.secret_not_applied, snapshot.ready, snapshot.failed, snapshot.deleted, volume.ready, volume.failed, volume.deleted, volume.recovered, egress_secret.created, egress_secret.updated, egress_secret.deleted, upstream_proxy.set, upstream_proxy.removed, credit.low, credit.empty. Kept 14 days.

## Query parameters

- `resourceId` string: Resource identifier (UUID).
- `type` 'sandbox.created' | 'sandbox.running' | 'sandbox.paused' | 'sandbox.woken' | 'sandbox.stopped' | 'sandbox.start_failed' | 'sandbox.wake_failed' | 'sandbox.host_unreachable' | 'sandbox.host_reachable' | 'sandbox.recovered' | 'sandbox.recovery_failed' | 'sandbox.files.changed' | 'sandbox.out_of_memory' | 'sandbox.secret_not_applied' | 'snapshot.ready' | 'snapshot.failed' | 'snapshot.deleted' | 'volume.ready' | 'volume.failed' | 'volume.deleted' | 'volume.recovered' | 'egress_secret.created' | 'egress_secret.updated' | 'egress_secret.deleted' | 'upstream_proxy.set' | 'upstream_proxy.removed' | 'credit.low' | 'credit.empty'
- `cursor` string: Resource identifier (UUID).
- `limit` integer: Page size, 1 to 100.

## Response `200`

Success

- object
  - `data` object[], required
    - `id` string, required
    - `type` 'sandbox.created' | 'sandbox.running' | 'sandbox.paused' | 'sandbox.woken' | 'sandbox.stopped' | 'sandbox.start_failed' | 'sandbox.wake_failed' | 'sandbox.host_unreachable' | 'sandbox.host_reachable' | 'sandbox.recovered' | 'sandbox.recovery_failed' | 'sandbox.files.changed' | 'sandbox.out_of_memory' | 'sandbox.secret_not_applied' | 'snapshot.ready' | 'snapshot.failed' | 'snapshot.deleted' | 'volume.ready' | 'volume.failed' | 'volume.deleted' | 'volume.recovered' | 'egress_secret.created' | 'egress_secret.updated' | 'egress_secret.deleted' | 'upstream_proxy.set' | 'upstream_proxy.removed' | 'credit.low' | 'credit.empty', required
    - `createdAt` string, required
    - `resourceId` string, nullable
    - `data` object, required: The resource as it was: data.sandbox, data.snapshot or data.volume; for credit.low and credit.empty, data.credit.
  - `nextCursor` string, nullable, required: Pass as cursor; null ends the list.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/withruntime/apis/runtime-cloud-api.md) · [All operations](https://skmtc.dev/withruntime/apis/runtime-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/withruntime/apis/runtime-cloud-api/revisions/6f4012286988?raw)