Skip to main content
POST
/
runs
/
{id}
/
preview
Preview URL
curl --request POST \
  --url https://api.example.com/runs/{id}/preview \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "port": 3000,
  "expires_in_secs": 3600
}
'
{
  "url": "https://preview.example.com/sb-a1b2c3d4/3000"
}

Authorizations

​
Authorization
string
header
required

JWT bearer token issued by fabro-web. See the Authentication guide for details.

Path Parameters

​
id
string
required

Unique run identifier (ULID).

Body

application/json

Request body for generating a preview URL from a sandbox port.

​
port
integer
required

Port number exposed by the sandbox.

Example:

3000

​
expires_in_secs
integer
required

Time-to-live for the preview URL in seconds.

Required range: 1 <= x <= 86400
Example:

3600

Response

Preview URL created

Response containing the generated preview URL.

​
url
string
required

Time-limited preview URL.

Example:

"https://preview.example.com/sb-a1b2c3d4/3000"