Skip to Content

TwentyThree™ API

API Method: /api/live/recording/start

Start recording from a live stream.

The call returns an upload_token which can later be used with /api/photo/list to retrieve one or more recordings. If a recording is split between starting and stopping the recording, all clips will share the same upload_token.


live_id (required)The ID for the stream for which you want to record.

Permission level

The minimum required permission level is:


Example XML Response

<response status="ok" permission_level="write" 
  message="The stream has started recording" cached="0"

Example JSON Response

  "status": "ok", 
  "message":"The stream has started recording",
  "live":{"upload_token": "live-678j35g34jh54309"},
  "p": "1",
  "size": "1",
  "site": { ...},
  "endpoint": "/api/live/start-recording"