Create a phone pairing link

Creates a short-lived pairing URL suitable for a QR code. The secret stays in the URL fragment. A paired phone may contribute camera or audio without logging in, but cannot read other evidence, submit the agent handoff, or publish. Reopening an active link resumes the same scoped capture session.

post/api/task-creations/{id}/phone-links

Request

  • Base URL
    https://www.toma.com
  • URL
    https://www.toma.com/api/task-creations/{id}/phone-links
  • Auth
    • HTTP bearer
    • or API key in cookie better-auth.session_token
    • or API key in header x-task-creation-token

Path parameters

idstring required

Request body

requestIdstring

Response

An expiring phone pairing URL. Its fragment contains a private secret; do not log or publish it.

idstring required
urlstring
expiresAtstring required
status'waiting' | 'connected' | 'received' | 'expired' | 'revoked' required

Changes

No recorded changes to this operation across all 1 revision of this API.