SandboxesManagement

Stream the changes of several sandboxes

Stream the changes of up to 100 sandboxes as server-sent events.

  • Each sandbox event carries the sandbox exactly as GET /v1/sandboxes/{idOrName} returns it to the caller.
  • The stream sends every sandbox at once, then again each time its response changes.
  • A removed event says that the stream sends no more events for a sandbox: it reached the deleted state, or the caller can no longer read it.
  • Close the stream after the last removed event. A browser EventSource opens a closed stream again by itself.
  • A ping event arrives every 25 s when no other event arrives.
  • The caller must be able to read every sandbox when the stream opens.
  • The stream ends after the last removed event.
GET
/v1/sandbox-events
AuthorizationBearer <token>

API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.

In: header

Query Parameters

id*array<string>|

Sandbox ID (ULID). Repeat the parameter for each sandbox.

Items1 <= items <= 100

Response Body

text/event-stream

application/problem+json

curl -X GET "https://example.com/v1/sandbox-events?id=string"
[  {    "data": {},    "event": "ping",    "id": 0,    "retry": 0  }]