API Reference

Set profile to videos

Set Profile to Videos

The Set Profile to Videos endpoint enables bulk assignment of video player profiles to multiple videos simultaneously. This powerful feature streamlines profile management by allowing you to apply consistent player configurations across multiple videos in a single operation, making it essential for campaign management and content organization.

Overview

This endpoint provides an efficient way to apply player profile configurations to multiple videos at once, eliminating the need for individual video configuration updates. The operation ensures complete synchronization across all system components, including database records, S3 storage, and cache systems, maintaining consistency throughout your video delivery infrastructure.

What You Need to Provide

To assign a profile to videos, specify:

  • Query Parameter: type=set-videos in the URL
  • Request Body: JSON object containing:
    • Videos Array: List of video IDs to configure (required)
    • Profile ID: UUID of the profile to apply (required)

All specified videos and the profile must belong to your authenticated account for the operation to succeed.

Common Use Cases

Campaign Management

Apply consistent branding and behavior profiles across all videos in a marketing campaign, ensuring uniform user experience and brand presentation throughout the campaign lifecycle.

Seasonal Updates

Quickly update multiple videos with seasonal branding profiles, promotional overlays, or special engagement features during specific time periods or events.

A/B Testing Deployment

Assign different profile variations to video sets for controlled testing of player configurations, engagement features, or conversion optimization strategies.

Content Organization

Group videos by content type, audience, or purpose by applying appropriate profiles that match viewing context and user expectations.

Bulk Configuration Changes

Update player settings across large video libraries when implementing new features, compliance requirements, or user experience improvements.

Request Format

The endpoint expects a JSON payload with two required fields:

  • Videos Array: Contains video IDs as strings
  • Profile ID: Single profile UUID to apply to all specified videos

The same profile configuration will be applied to every video in the request, ensuring consistency across the entire set.

Authentication Requirements

This endpoint requires valid authentication credentials with appropriate permissions to modify both video configurations and access the specified profile within your account.

Language
Credentials
Header
Click Try It! to start a request and see the response here!