Skip to content

Is the app's dev server session serving right now?

GET
/api/workspaces/{workspaceId}/apps/{id}/dev-preview/status
curl --request GET \
--url http://localhost:8080/api/workspaces/example/apps/example/dev-preview/status \
--cookie auth_session=<auth_session>

Cheap truth for the workbench: the session socket AND the port, not client-side state. Never starts a sandbox. Lets the UI notice a server stopped from inside its own terminal (Ctrl-C) and flip to the launch state.

workspaceId
required
string
id
required
string

Successful response

Media typeapplication/json
object
success

Whether the request succeeded.

boolean
data

Endpoint-specific response payload.

message
string
error
string

Example

{
"message": "Operation completed",
"error": "Error message"
}

Invalid request

Media typeapplication/json
object
success
boolean
error
string

Example

{
"error": "Error message"
}

Internal server error

Media typeapplication/json
object
success
boolean
error
string

Example

{
"error": "Error message"
}