Create a preview link token for a phone app.

A short-lived token that makes the app's preview show this app. Open sandbox.devUrl from GET .../cli/projects/{projectId}/context with #previewToken=<token> appended; without it the preview shows the stock app.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:clientportal-ai.readonly

Auth methods:OAuthPrivate Integration

Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

The API version.

Available optionsv3

Example:v3

Path Parameters

projectIdstringrequired

The app's id.

Possible values: Value must match regular expression ^prj_[A-Za-z0-9_-]+$

Example:prj_a7ca4adc-be67-40ff-ae79-4f5acf56ac67

Body

application/json

expiresInSecondsinteger

How long the preview link works, in seconds.

Possible values: >= 60 and <= 3600

Example:900

Response

201

application/json

Opaque token bound to the authenticated location.

tokenstringrequired

Opaque bearer. The control plane persists only its SHA-256 hash. Open the app's preview (sandbox.devUrl from the app's context) with it in the fragment, <devUrl>/#previewToken=<token>; without it the preview shows the stock app.

Possible values: Value must match regular expression ^[A-Za-z0-9_-]{32,128}$

Example:Vq3n8XkT2pLw9sYc4RbJ7hMd1FgZ6aEu

expiresAtstring<date-time>required

When the token stops working.

Example:2026-10-23T11:40:00.000Z