Fork a sandbox
Create a point-in-time fork of a running sandbox. The source sandbox continues running.
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.
Fork mode: 'filesystem' (disk only) or 'full' (memory + disk).
"filesystem"Value in
- "filesystem"
- "full"
Sandbox name: lowercase letters, digits and hyphens, 1 to 40 characters, no hyphen at the start or the end. Unique among the live sandboxes of the project. It must not be a ULID (the sandbox ID format). The fork never takes the name of the source. Omit or send null for no name.
^[a-z0-9]([a-z0-9-]*[a-z0-9])?$length <= 40Tags for the fork. Omit to inherit, or provide an empty array for no tags.
items <= 20Response Body
application/json
application/problem+json
curl -X POST "https://example.com/v1/sandboxes/string/fork" \ -H "Content-Type: application/json" \ -d '{}'{ "cache_key": "string", "id": "string", "image_ref": "string", "name": "string", "state": "creating", "tags": [ "string" ]}{ "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"}