Skip to main content
POST
Open a live view of an internal tester

Authorizations

Authorization
string
header
required

A project token (apsio_pt_v0...), which reads exactly one project, or an OAuth access token issued for the API, which reads what its user can. Access tokens issued for Apsio's MCP server are accepted only from the MCP server itself.

Path Parameters

projectId
string
required
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"0192f3a4-0000-7000-8000-00000000a101"

Body

application/json
tester_id
string

The internal tester (live-testers).

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
device
string

Instead of tester_id: one device's install id (app.installation.id) or user hash. The server finds the current tester whose match is that device's; none answers as an unknown tester_id. The value is never kept, logged or answered; the audit records only that the ticket was asked by device.

Required string length: 1 - 128

Response

The ticket.

ticket
string
required

Opaque; valid for 60 seconds.

url
string
required

The WebSocket URL of the live view, ticket included.

Example:

"wss://live.apsio.cloud/v1/live/view?ticket=7b2276…"

expires_at
string
required
Example:

"2026-10-28T12:01:00.000Z"