Using the API
Runs
Human-in-the-Loop
Run Outputs
More
Preview URL
curl --request POST \
--url https://api.example.com/api/v1/runs/{id}/preview \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"port": 3000,
"expires_in_secs": 3600,
"signed": false
}
'{
"url": "https://preview.example.com/sb-a1b2c3d4/3000",
"token": "preview-token-123"
}Human-in-the-Loop
Preview URL
Generates a preview URL for a port exposed by the run’s sandbox environment.
POST
/
api
/
v1
/
runs
/
{id}
/
preview
Preview URL
curl --request POST \
--url https://api.example.com/api/v1/runs/{id}/preview \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"port": 3000,
"expires_in_secs": 3600,
"signed": false
}
'{
"url": "https://preview.example.com/sb-a1b2c3d4/3000",
"token": "preview-token-123"
}Authorizations
BearerAuthSessionCookie
Raw dev token passed as Authorization: Bearer fabro_dev_... when server.auth.methods includes dev-token.
Path Parameters
Unique run identifier (ULID).
Body
application/json
Request body for generating a preview URL from a sandbox port.
⌘I