Skip to content

Build the app in its session and mint a preview link

POST
/api/workspaces/{workspaceId}/apps-v2/{id}/preview

Runs npm install (when needed) and npm run build in the actor’s sandbox session, then returns a short-lived token-gated URL serving the built dist/. The URL is cookie-free and meant for a sandboxed iframe.

workspaceId
required
string
id
required
string
object

Successful response

object
success

Whether the request succeeded.

boolean
data

Endpoint-specific response payload.

message
string
Example
Operation completed
error
string
Example
Error message

Invalid request

object
success
boolean
error
string
Example
Error message

Internal server error

object
success
boolean
error
string
Example
Error message