Sandboxes

Share a sandbox with its project

Set the sandbox's sharing level (use or manage). Owner or project/org admin only.

PUT
/v1/sandboxes/{id}/share

Set the sandbox's sharing level (use or manage). Owner or project/org admin only.

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.

share_type*string

Sharing level: use (members operate/readers observe) or manage (members can also delete). Use the unshare endpoint to make a sandbox private.

Value in"use" | "manage"

Response Body

application/json

application/problem+json

curl -X PUT "https://api-dev.tektona.ai/v1/sandboxes/string/share" \  -H "Content-Type: application/json" \  -d '{    "share_type": "use"  }'
{  "$schema": "https://api-dev.tektona.ai/schemas/SandboxShareResponse.json",  "id": "string",  "share_type": "string"}