403 Forbidden – MediaStream API

Request

GET /api/v4/streams/live/broadcast 403 Forbidden

Authorization:Bearer <token>

X-Client-ID:7f4a2b91-3c08-4e1d-b6f5-a2e9d3c01f88

Accept:application/json

X-Stream-Protocol:RTMP/2.0, HLS/4, DASH

Response Headers

HTTP/1.1 403 Forbidden

Content-Type:application/json; charset=utf-8

X-Request-ID:req_9c3f1b72e4ad058

X-RateLimit-Limit:0

X-RateLimit-Remaining:0

WWW-Authenticate:Bearer realm="mediastream", error="insufficient_scope"

Retry-After:—

Cache-Control:no-store

Server:nginx/1.24.0

Response Body

application/json 218 bytes

{
  "error": "forbidden",
  "code": 4031,
  "message": "Access to this resource requires broadcast scope. "
            "Your token does not have the required permissions.",
  "details": {
    "required_scope": "streams:broadcast:read",
    "granted_scopes": ["streams:vod:read", "account:profile"],
    "resource": "/api/v4/streams/live/broadcast",
    "region": "eu-west-1"
  },
  "docs": "https://docs.mediastream.io/errors/4031",
  "timestamp": "2026-05-05T09:14:37Z",
  "request_id": "req_9c3f1b72e4ad058"
}

Troubleshooting

CauseToken issued without streams:broadcast:read scope

ResolutionRe-authenticate via POST /oauth2/token with correct scope

Plan requiredBroadcast API access requires Pro tier or above

Supportsupport@mediastream.io — include request_id