Skip to navigation
LIVE STREAM APILive playback

Update domain restrictions for a playback ID

Updates domain-level access restrictions for a specific playback ID of a live stream. Restricts playback to specific domains or blocks unauthorized ones. Replaces the existing domain restrictions while leaving user-agent restrictions unchanged.

How it works:

  1. Make a PATCH request with your desired domain access configuration.
  2. Set a default policy (allow or deny) and specify domain names in the allow or deny lists.
  3. Commonly used to restrict live playback to your website or approved client domains.

Example: Allow playback only from example.com and deny all others by setting "defaultPolicy": "deny" and "allow": ["example.com"].

Authentication

AuthorizationBasic

FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request.

  • Username: Access Token ID
  • Password: Secret Key

Activate your FastPix account to generate your API credentials. See the guide here

Path parameters

streamIdstringRequired
playbackIdstringRequiredformat: "uuid"

Request

This endpoint expects an object.
defaultPolicyenumOptionalDefaults to allow

Fallback behavior for domains not listed in the allow or deny lists.

Allowed values:
allowlist of stringsOptional

List of domains (exact or wildcard) explicitly allowed to play the stream. Maximum 25 entries.

denylist of stringsOptional
List of domains explicitly denied from playing the stream. Maximum 25 entries.

Response

Successfully updated domain restrictions
successbooleanOptional
Shows the request status. Returns true for success and false for failure.
dataobjectOptional