SandboxesAccess

Transfer sandbox ownership

Reassign the sandbox to a new owner (a project writer or higher). Owner or project/org admin only. Outstanding access tokens are invalidated.

PUT
/v1/sandboxes/{idOrName}/transfer
AuthorizationBearer <token>

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

In: header

Path Parameters

idOrName*string

Sandbox ID (ULID) or name

Query Parameters

org?string

Required when the path names the sandbox by name.

project?string

Required when the path names the sandbox by name.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

reason?string

Optional reason recorded in the access audit trail.

to*string

New owner: email or user ID.

Response Body

application/json

application/problem+json

curl -X PUT "https://example.com/v1/sandboxes/string/transfer" \  -H "Content-Type: application/json" \  -d '{    "to": "string"  }'
{  "id": "string",  "owner_user_id": "string"}