Update lifecycle config
Update the lifecycle configuration for a sandbox.
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.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Duration string (e.g. '30d'). Empty string to disable.
Duration string (e.g. '15m'). Empty string to disable.
Pause mode for auto-pause.
Value in
- "hibernate"
- "suspend"
Wake on incoming activity.
Response Body
application/json
application/problem+json
curl -X PUT "https://example.com/v1/sandboxes/string/lifecycle" \ -H "Content-Type: application/json" \ -d '{}'{ "auto_delete_after": "string", "auto_pause_after": "string", "auto_pause_mode": "string", "auto_resume": true, "configured": { "auto_delete_after": "string", "auto_pause_after": "string", "auto_pause_mode": "string", "auto_resume": true }, "run_deadline": "2019-08-24T14:15:22Z", "running_since": "2019-08-24T14:15:22Z", "source": { "auto_delete_after": "own", "auto_pause_after": "own", "auto_pause_mode": "own", "auto_resume": "own" }}{ "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"}Resume a sandbox PUT
Resume a paused (hibernated or suspended) sandbox. - A hibernated sandbox resumes with its memory only on a runner node whose CPU can restore it. - With `discard_memory`, a hibernated sandbox starts from its disk instead. Its memory image is deleted, and it can run on any node with room. A refusal can carry its cause code in the problem type, all with 503: - `memory_restore_no_capacity`: no node can restore the memory now. The sandbox keeps the memory. To resume now, set `discard_memory`. - `disk_node_unavailable` (with `discard_memory`): the disk is only on the node that paused the sandbox, and that node is unavailable or full. The memory is kept. - `memory_discarded` (with `discard_memory`): the resume failed after the memory was discarded. The sandbox is suspended. To retry, resume without `discard_memory`.
Set project sandbox lifecycle defaults PUT
Full replacement. A null field clears the project default (sandboxes fall through to the platform default). Requires project admin role.