Sign in
phones

Mint a telemetry stream URL

Mints a fresh telemetry_url for an active session — the same read-only WebSocket URL POST /phones:allocate returns once (live trace spans + output logs for exactly this session, 3h token). This is the telemetry/frames leg, distinct from the live-view (video) token: it can only watch the trace, never the screen, and never drive the phone. The stream's end frame is the session-end signal. Refused for inactive sessions — an ended session's telemetry is served by GET /phones/sessions/{session_id}/frames — and for sessions outside the caller's organization (reads as not found).

post/phones/sessions/{session_id}/telemetry-token

Path parameters

session_idstring uuid required

Phone session identifier

Phone session identifier

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

session_idstring required

Session the URL is scoped to.

telemetry_urlstring required

WebSocket URL for the session's live telemetry stream (trace spans + output logs, read-only). Dies with the session.

Example response

{
  "$schema": "/api/v1/PhoneTelemetryTokenResponse.json"
}

Changes