Zerocut: The fair way to get paid for your content.

Add a live streaming session record via the API.

Authorization

API Key

x-api-key<token>

API key used for authentication

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

platform*string

Platform name (e.g., 'twitch', 'youtube')

Length1 <= length

startTime*string

Session start time (ISO 8601)

Match

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

Formatdate-time

endTime*string

Session end time (ISO 8601)

Match

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

Formatdate-time

peakViewerCount?integer

Peak viewer count during the session

Range0 < value <= 9007199254740991

finalViewerCount?integer

Final viewer count at session end

Range0 < value <= 9007199254740991

Response Body

`application/json`

curl -X POST "https://loading/api/v1/live-session/create" \  -H "Content-Type: application/json" \  -d '{    "platform": "string",    "startTime": "2019-08-24T14:15:22Z",    "endTime": "2019-08-24T14:15:22Z"  }'

{
  "id": "00000000-0000-0000-0000-000000000000",
  "userId": "test-user-id",
  "platform": "twitch",
  "startTime": "2026-03-14T11:35:08.458Z",
  "endTime": "2026-03-14T12:35:08.458Z",
  "peakViewerCount": 500,
  "finalViewerCount": 450,
  "createdAt": "2026-03-14T11:35:08.458Z",
  "updatedAt": "2026-03-14T11:35:08.458Z"
}

{
  "error": "string",
  "code": "string",
  "details": {}
}

Add Live Session

Authorization

Request Body

Response Body

200application/json

401application/json

`application/json`

`application/json`