Sign in

v53

OpenAPI 3.1.0raw.githubusercontent.com2026-08-0363105115.0 KB
sessions

Start a session-owned server from .ao/launch.json and open its application preview

post/api/v1/sessions/{sessionId}/preview/server

Path parameters

sessionIdstring required

Session identifier, e.g. project-1.

Session identifier, e.g. project-1.

Headers

X-AO-Browser-Capabilitystring

Opaque browser capability injected into the owning AO worker.

Opaque browser capability injected into the owning AO worker.

Request body

configurationstring

Named preview configuration. Optional when exactly one configuration exists.

Response

OK

configurationstring
errorstring
logsstring[] required
portinteger
sessionIdstring required
startedAtstring date-time
state'stopped' | 'starting' | 'ready' | 'stopping' | 'failed' required
targetKind'app' | 'api'
urlstring