Tektona Docs

Issue a signed preview URL for a port on the sandbox. Returns a canonical URL for public sandboxes or a short-lived token URL otherwise.

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)

port*integer

In-VM port.

Formatint64

Range1 <= value <= 65535

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

ttl_seconds?integer

Optional TTL in seconds. Bounds 60..86400. When absent and sandbox is public, returns the public URL with no token. When absent and sandbox is private, default 12h applies.

Formatint64

Range0 <= value <= 86400

Response Body

`application/json`

`application/problem+json`

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

{  "$schema": "https://api-dev.tektona.ai/schemas/PreviewURLResponse.json",  "expires_at": "2019-08-24T14:15:22Z",  "kind": "public",  "token": "string",  "url": "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"}

Issue a preview URL for a sandbox port