Skip to main content
GET
Get preview URL

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

app_id
string
required

Response

Successful Response

A preview URL for an app, and the sandbox serving it.

preview_url
string
required

Where the app is served as it currently stands in the app editor, including changes that haven't been published. Usually a host with no scheme, so add https:// before you open it in a browser or an iframe. For some imported apps it's already a full URL with its own query parameters, so add the scheme only when it's missing and keep the query.

Example:

"preview-6820f3a4e7b91d003c45a1f2.base44.app"

sandbox_info
SandboxInfo · object
required

Details of the sandbox serving this preview, including whether it had to be started for this request.

preview_token
string | null

Short-lived token the preview URL needs to authenticate against the preview proxy. It works once and expires after 5 minutes. Add it to the preview's query as _preview_token. Treat it as a credential and don't share it, because anyone holding it can load the app before it is published.

Example:

"FH-j7wHS7IR_fC1tUh4wCd_fNV1XGC479cuqNSYi9mA"

bridge_injected
boolean
default:true

Whether the preview host injects the builder bridge. False when the platform proxy is disabled and the preview falls back to the sandbox's own host, so the editor knows the bridge's mount/paint signals will never arrive and must not wait for them.