Stream live sandbox stats
Stream the CPU, memory and disk usage of a sandbox as server-sent events. The stream sends the last sample at once when it is at most 15 s old, then a new sample about every 3 s while the sandbox runs. A ping event arrives every 25 s when no sample arrives.
Authorization
apiKey API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.
In: header
Path Parameters
Sandbox ID (ULID) or name
Query Parameters
Required when the path names the sandbox by name.
Required when the path names the sandbox by name.
Response Body
text/event-stream
application/problem+json
curl -X GET "https://example.com/v1/sandboxes/string/stats/live"[ { "data": {}, "event": "ping", "id": 0, "retry": 0 }]{ "detail": "Property foo is required but is missing.", "errors": [ { "location": "string", "message": "string", "value": null } ], "instance": "https://example.com/error-log/abc123", "status": 400, "title": "Bad Request", "type": "https://example.com/errors/example"}Get sandbox stats history GET
Get the CPU, memory and disk usage of a sandbox over time. The server keeps a sample every 3 s for 7 days and groups the samples to a step that gives at most 1,500 points. The answer also lists the periods in which the sandbox was paused, and the changes of its size that took effect, in the range. The live stream at `/v1/sandboxes/{idOrName}/stats/live` sends the newest samples.
Detach a sandbox's egress proxy profile PUT
Remove the sandbox's egress proxy profile attachment. The sandbox keeps its egress network policy; it just loses credential injection. A running sandbox picks up the change within seconds, without a restart. Detaching with nothing attached returns 409.