DELETE /lives

Deletes one or more live streams. The body is a JSON array of objects, each containing a live_id — supporting bulk deletion in a single request. Already-finished lives and their VODs are detached from the request scope (deleting a live does not delete the recorded VOD; that lives independently in the videos endpoint).

📘

Authorization

Requires a valid Panda API token sent in the Authorization header (no Bearer prefix).

HTTP Method & Path

DELETE /lives

Base URL: https://api-v2.pandavideo.com.br

Authentication Requirements

Parameters

Request Body

Content-Type: application/json

The body is a JSON array. Send one object per live to delete. To delete a single live, send an array with a single element.

Body (array of objects)

Each item in the array has the following fields:

Delete a single live

[
  { "live_id": "11111111-2222-3333-4444-555555555555" }
]

Delete multiple lives (bulk)

[
  { "live_id": "11111111-2222-3333-4444-555555555555" },
  { "live_id": "22222222-3333-4444-5555-666666666666" },
  { "live_id": "33333333-4444-5555-6666-777777777777" }
]

⚠️

Heads up: the body must be an array, not a plain object. Sending a single object like {"live_id":"..."} will fail with 400 must have required property 'live_id' or be rejected by the schema validator. Always wrap it in [ ].

Response

Success Response (200)

Returns a confirmation message listing the deleted live IDs.

{
  "message": "Live with ids: 11111111-2222-3333-4444-555555555555 was deleted"
}

Response Schema

Error Responses

• 400 Bad Request — { "errMsg": "must have required property 'live_id'" } when the body item is missing live_id or has the wrong shape.
• 401 Unauthorized — Authentication failed or not provided.
• 404 Not Found — One or more live_id values do not exist or do not belong to the authenticated user.
• 500 Internal Server Error — Server-side error. Please try again later.

Example Usage

cURL — delete a single live

curl -X DELETE \
  'https://api-v2.pandavideo.com.br/lives' \
  -H 'Authorization: your_api_token_here' \
  -H 'Content-Type: application/json' \
  -d '[
  { "live_id": "11111111-2222-3333-4444-555555555555" }
]'

cURL — bulk delete

curl -X DELETE \
  'https://api-v2.pandavideo.com.br/lives' \
  -H 'Authorization: your_api_token_here' \
  -H 'Content-Type: application/json' \
  -d '[
  { "live_id": "11111111-2222-3333-4444-555555555555" },
  { "live_id": "22222222-3333-4444-5555-666666666666" }
]'