Skip to Content

TwentyThree™ API

API Method: /api/live/upload-image

Upload a thumbnail or preview image for the live stream.

Parameters

ParameterDescription
live_id (required)The ID for the stream you're uploading an image for.
typeWhich type of image is being uploaded? Options are `thumbnail` and `preview` and the default is `thumbnail`
file (required)The file to upload. (Note that this parameter − neither the filename nor the file content − shouldn't be included in the api signature).

Permission level

The minimum required permission level is:

read

Example XML Response

<response status="ok" permission_level="write" 
  message="The image has been uploaded" cached="0">

Example JSON Response

{
  "status": "ok", 
  "message":"The image has been uploaded",
  "permission_level":"write",
  "cached":"0",
  "p": "1",
  "size": "1",
  "site": { ...},
  "endpoint": "/api/live/upload-image"
}