Documentation

The lifecycle API provides RESTful endpoints to request the latest sandbox lifecycle events. This allows you to track when sandboxes are created, paused, resumed, updated, snapshotted, or killed, along with metadata. All requests require authentication using your team API key.

Retention

Sandbox lifecycle events are retained for 7 days by default. After the retention window passes, a sandbox’s events are no longer available through this API. Query Parameters:

offset (optional): Number of events to skip (default: 0, min: 0)
limit (optional): Number of events to return (default: 10, min: 1, max: 100)
orderAsc (optional): Sort order - true for ascending, false for descending (default: false)
types (optional): Filter by event type. Can be specified multiple times to match any of the given types.

import { Sandbox } from 'e2b'

const sbx = await Sandbox.create()

// Get the latest events for a specific sandbox
const resp1 = await fetch(
  `https://api.e2b.app/events/sandboxes/${sbx.id}`,
  {
    method: 'GET',
    headers: {
      'X-API-Key': E2B_API_KEY,
    },
  }
)
const sandboxEvents = await resp1.json()

// Get the latest 10 events for all sandboxes associated with the team
const resp2 = await fetch(
  'https://api.e2b.app/events/sandboxes?limit=10',
  {
    method: 'GET',
    headers: {
      'X-API-Key': E2B_API_KEY,
    },
  }
)
const teamSandboxEvents = await resp2.json()

// Filter events by type
const resp3 = await fetch(
  'https://api.e2b.app/events/sandboxes?types=sandbox.lifecycle.created&types=sandbox.lifecycle.killed',
  {
    method: 'GET',
    headers: {
      'X-API-Key': E2B_API_KEY,
    },
  }
)
const filteredEvents = await resp3.json()

console.log(teamSandboxEvents)

// [
//   {
//     "version": "v1",
//     "id": "f5911677-cb60-498f-afed-f68143b3cc59",
//     "type": "sandbox.lifecycle.killed",
//     "eventData": null,
//     "sandboxBuildId": "a979a14b-bdcc-49e6-bc04-1189fc9fe7c2",
//     "sandboxExecutionId": "1dae9e1c-9957-4ce7-a236-a99d5779aadf",
//     "sandboxId": "${SANDBOX_ID}",
//     "sandboxTeamId": "460355b3-4f64-48f9-9a16-4442817f79f5",
//     "sandboxTemplateId": "rki5dems9wqfm4r03t7g",
//     "timestamp": "2025-08-06T20:59:36Z"
//   },
//   {
//     "version": "v1",
//     "id": "30b09e11-9ba2-42db-9cf6-d21f0f43a234",
//     "type": "sandbox.lifecycle.updated",
//     "eventData": {
//       "set_timeout": "2025-08-06T20:59:59Z"
//     },
//     "sandboxBuildId": "a979a14b-bdcc-49e6-bc04-1189fc9fe7c2",
//     "sandboxExecutionId": "1dae9e1c-9957-4ce7-a236-a99d5779aadf",
//     "sandboxId": "${SANDBOX_ID}",
//     "sandboxTeamId": "460355b3-4f64-48f9-9a16-4442817f79f5",
//     "sandboxTemplateId": "rki5dems9wqfm4r03t7g",
//     "timestamp": "2025-08-06T20:59:29Z"
//   },
//   [...]
//   {
//     "version": "v1",
//     "id": "0568572b-a2ac-4e5f-85fa-fae90905f556",
//     "type": "sandbox.lifecycle.created",
//     "eventData": null,
//     "sandboxBuildId": "a979a14b-bdcc-49e6-bc04-1189fc9fe7c2",
//     "sandboxExecutionId": "1dae9e1c-9957-4ce7-a236-a99d5779aadf",
//     "sandboxId": "${SANDBOX_ID}",
//     "sandboxTeamId": "460355b3-4f64-48f9-9a16-4442817f79f5",
//     "sandboxTemplateId": "rki5dems9wqfm4r03t7g",
//     "timestamp": "2025-08-06T20:59:24Z"
//   }
// ]

import requests
from e2b import Sandbox

sbx = Sandbox.create()

# Get the latest events for a specific sandbox
resp1 = requests.get(
    f"https://api.e2b.app/events/sandboxes/{sbx.sandbox_id}",
    headers={
        "X-API-Key": E2B_API_KEY,
    }
)
sandbox_events = resp1.json()

# Get the latest 10 events for all sandboxes associated with the team
resp2 = requests.get(
    "https://api.e2b.app/events/sandboxes?limit=10",
    headers={
        "X-API-Key": E2B_API_KEY,
    }
)
team_sandbox_events = resp2.json()

# Filter events by type
resp3 = requests.get(
    "https://api.e2b.app/events/sandboxes",
    params={"types": ["sandbox.lifecycle.created", "sandbox.lifecycle.killed"]},
    headers={
        "X-API-Key": E2B_API_KEY,
    }
)
filtered_events = resp3.json()

print(team_sandbox_events)

# [
#   {
#     "version": "v1",
#     "id": "0568572b-a2ac-4e5f-85fa-fae90905f556",
#     "type": "sandbox.lifecycle.killed",
#     "eventData": null,
#     "sandboxBuildId": "a979a14b-bdcc-49e6-bc04-1189fc9fe7c2",
#     "sandboxExecutionId": "1dae9e1c-9957-4ce7-a236-a99d5779aadf",
#     "sandboxId": "${SANDBOX_ID}",
#     "sandboxTeamId": "460355b3-4f64-48f9-9a16-4442817f79f5",
#     "sandboxTemplateId": "rki5dems9wqfm4r03t7g",
#     "timestamp": "2025-08-06T20:59:36Z"
#   },
#   {
#     "version": "v1",
#     "id": "e7013704-2c51-4dd2-9f6c-388c91460149",
#     "type": "sandbox.lifecycle.updated",
#     "eventData": {
#       "set_timeout": "2025-08-06T20:59:59Z"
#     },
#     "sandboxBuildId": "a979a14b-bdcc-49e6-bc04-1189fc9fe7c2",
#     "sandboxExecutionId": "1dae9e1c-9957-4ce7-a236-a99d5779aadf",
#     "sandboxId": "${SANDBOX_ID}",
#     "sandboxTeamId": "460355b3-4f64-48f9-9a16-4442817f79f5",
#     "sandboxTemplateId": "rki5dems9wqfm4r03t7g",
#     "timestamp": "2025-08-06T20:59:29Z"
#   },
#   [...]
#   {
#     "version": "v1",
#     "id": "f29ef778-2743-4c97-a802-7ba67f84ce24",
#     "type": "sandbox.lifecycle.created",
#     "eventData": null,
#     "sandboxBuildId": "a979a14b-bdcc-49e6-bc04-1189fc9fe7c2",
#     "sandboxExecutionId": "1dae9e1c-9957-4ce7-a236-a99d5779aadf",
#     "sandboxId": "${SANDBOX_ID}",
#     "sandboxTeamId": "460355b3-4f64-48f9-9a16-4442817f79f5",
#     "sandboxTemplateId": "rki5dems9wqfm4r03t7g",
#     "timestamp": "2025-08-06T20:59:24Z"
#   }
# ]

​Retention

Retention