Set project sandbox lifecycle defaults
Full replacement. A null field clears the project default (sandboxes fall through to the platform default). Requires project admin role.
Authorization
apiKey API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.
In: header
Path Parameters
Organization name
^[a-z0-9][a-z0-9-]*[a-z0-9]$2 <= length <= 64Project name
^[a-z0-9][a-z0-9-]*[a-z0-9]$2 <= length <= 64Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Default delete TTL; null = no default, "0" = never.
Default idle timeout; null = no default, "0" = never.
Default pause mode; null = no default.
Value in
- "hibernate"
- "suspend"
Default auto-resume; null = no default.
Response Body
application/json
application/problem+json
curl -X PUT "https://example.com/v1/orgs/string/projects/string/lifecycle-defaults" \ -H "Content-Type: application/json" \ -d '{ "auto_delete_after": "string", "auto_pause_after": "string", "auto_resume": true }'{ "auto_delete_after": "string", "auto_pause_after": "string", "auto_pause_mode": "hibernate", "auto_resume": true}{ "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"}Update lifecycle config PUT
Update the lifecycle configuration for a sandbox.
Create a sandbox POST
Create a new sandbox. - The request waits up to 15 seconds for a node to be chosen. If placement is still pending, it returns 201 with the current state. - With `wait=true`, it then waits up to 30 more seconds for `running` or a terminal state. On timeout, it returns 201 with the current state. - It also returns when the node has downloaded the template image for 2 seconds. - This request does not stream progress. While the node downloads the image, `GET /v1/sandboxes/{idOrName}` returns `image_pull`.