POST /live_stream_key

Creates a live stream key for one of your sub-accounts. The parent account must own the target sub-account.

📘

Authorization

Only parent accounts create live stream keys for their sub-accounts. The subaccount_id must belong to a sub-account owned by the authenticated parent. Sub-account-tier callers are rejected.

HTTP Method & Path

POST /live_stream_key

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

Authentication Requirements

• Security Scheme: PandaAuth (apiKey)
• Header: Authorization: <your_api_token> (no Bearer prefix)

Parameters

Request Body

Content-Type: application/json

📘

The first key created for an account is always forced to default: true. Setting set_default: true clears default on the account's other keys (scoped per sub-account). Unknown fields are rejected (additionalProperties: false).

Example Request

{ "subaccount_id": "efcb5915-df17-46b6-bfd8-e8998bc94917", "title": "Main Stream Key", "set_default": true }

Response

Success Response (200)

{
  "id": "08d7f7aa-25ff-47af-9892-b5e52c6b5a93",
  "title": "Main Stream Key",
  "stream_key": "d377666e-a3a8-410f-a5a3-d80e5b2b2888",
  "created_at": "2026-04-22T15:36:19.323Z",
  "default": true,
  "subaccount_id": "efcb5915-df17-46b6-bfd8-e8998bc94917"
}

Error Responses

Validation and business failures return 400 Bad Request, e.g.:

• title missing/too short (validation).
• "Subaccounts are not allowed to create stream keys"
• "subaccount not found." / "invalid subaccount."
• "customer not found" / "subscription not found"
• "the plan has no slot available to create stream key"

Other: 401 Unauthorized; 404 Not Found ("User not found"); 500 Internal Server Error.

Example Usage

cURL

curl -X POST \
  'https://api-v2.pandavideo.com.br/live_stream_key' \
  -H 'Authorization: your_api_token_here' \
  -H 'Content-Type: application/json' \
  -d '{ "subaccount_id": "your_sub_account_id_here", "title": "Main Stream Key", "set_default": true }'