Update user-agent restrictions for a playback ID

This endpoint allows updating user-agent restrictions for a specific playback ID associated with a media asset. It can be used to allow or deny specific user-agents during playback request evaluation.

How it works:

  1. Make a PATCH request to this endpoint with your desired user-agent access configuration.
  2. Specify a default policy (allow or deny) and provide specific allow or deny lists.
  3. Use this to restrict access to specific browsers, devices, or bots.

Example: A developer may configure a playback ID to deny access from known scraping user-agents while allowing all others by default.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

The unique identifier assigned to the media when created. The value must be a valid UUID.

uuid
required

The unique identifier assigned to the playback when created. The value must be a valid UUID.

Body Params
string
enum
Defaults to allow

The default behavior when a user-agent is not listed in allow or deny.

Allowed:
allow
array of strings
Defaults to Mozilla/55.0 (Macintosh; Intel Mac OS X 10_15_7)

List of user-agent substrings explicitly allowed.

allow
deny
array of strings
Defaults to

List of user-agent substrings explicitly denied.

deny
Responses

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json