---
title: "Mint a telemetry stream URL"
method: POST
path: "/phones/sessions/{session_id}/telemetry-token"
tags: ["phones"]
---

# Mint a telemetry stream URL

`POST /phones/sessions/{session_id}/telemetry-token`

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).

## Path parameters

- `session_id` string, uuid, required — Phone session identifier

## Response `200`

OK

- PhoneTelemetryTokenResponse — Telemetry-token mint response.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `session_id` string, required — Session the URL is scoped to.
  - `telemetry_url` string, required — WebSocket URL for the session's live telemetry stream (trace spans + output logs, read-only). Dies with the session.

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/axilioai/apis/axilio-api.md) · [All operations](https://skmtc.dev/axilioai/apis/axilio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/axilioai/axilio-api/revisions/8a66f81813b3/schema)