Skip to main content
GET
Get a preview URL

Authorizations

Authorization
string
header
required

Personal byk_ API key; user-principal, resolved to a tenant by org context.

Headers

X-Bonya-Organization-ID
string

Org context. Omitted means the caller's personal organization. A well-formed non-member org is 404; malformed is 400.

Path Parameters

sandbox_id
string
required
preview_id
string
required
Pattern: ^pv-[a-z2-7]{26}$

Response

Preview

id
string
required

Preview id, for example pv-e7otwsh2azaf2yzffkqlfcxyya.

sandbox_id
string
required
port
integer
required
auth
enum<string>
default:private
required

private requires a grant token, exchanged once at the grant's exchange_url for a host-scoped cookie; public needs no token.

Available options:
private,
public
url
string<uri>
required

Token-free preview URL.

created_by_user_id
string
required
created_at
string<date-time>
required
deleted_at
string<date-time>