SandboxesAccess

Share a sandbox with its project

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

PUT
/v1/sandboxes/{idOrName}/share
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.

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://example.com/v1/sandboxes/string/share" \  -H "Content-Type: application/json" \  -d '{    "share_type": "use"  }'
{  "id": "string",  "share_type": "string"}