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.