Sign in
AI Applications

Mint a short-lived URL for a port running in the application harness sandbox. This intentionally does not return the bare `ws-…` hostname: application sandboxes always have a private preview password and only the gateway can exchange this grant for the preview cookie.

post/ai/applications/{application_public_id}/preview-link

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/ai/applications/{application_public_id}/preview-link
  • Auth: HTTP bearer

Path parameters

application_public_idstring required

Request body

pathstring nullable

Optional same-origin path to open after the preview grant is exchanged.

portinteger required

The development server port detected or selected in the sandbox.

Response

expires_atinteger required
urlstring required

A short-lived authenticated URL. Its fragment carries the grant and never reaches the development server or referrer headers.

Changes

No recorded changes to this operation across all 50 revisions of this API.