Tektona Docs

Create a point-in-time fork of a running sandbox. The source sandbox continues running.

Authorization

apiKey

AuthorizationBearer <token>

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

In: header

Path Parameters

id*string

Sandbox ID (ULID)

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

mode?string

Fork mode: 'filesystem' (disk only) or 'full' (memory + disk).

Default"filesystem"

Value in"filesystem" | "full"

Response Body

`application/json`

`application/problem+json`

curl -X POST "https://api-dev.tektona.ai/v1/sandboxes/string/fork" \  -H "Content-Type: application/json" \  -d '{}'

{  "$schema": "https://api-dev.tektona.ai/schemas/ForkResponse.json",  "cache_key": "string",  "id": "string",  "image_ref": "string",  "state": "string"}

{  "$schema": "https://api-dev.tektona.ai/schemas/ErrorModel.json",  "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"}

Fork a sandbox