Permanently deletes a video player profile
Delete Profile
The Delete Profile endpoint permanently removes a video player profile from your account. This endpoint performs a complete cleanup operation, removing all profile data from both the database and associated storage systems, making it essential for profile lifecycle management and account maintenance.
Overview
This endpoint provides a secure way to permanently delete profiles that are no longer needed. The deletion process is comprehensive, removing the profile configuration from all system components including the primary database, S3 storage, and any associated cache entries. Once deleted, a profile cannot be recovered and must be recreated if needed again.
What You Need to Provide
To delete a profile, specify:
- Profile ID: The unique UUID identifier in the URL path
The system automatically validates that the profile belongs to your authenticated account before proceeding with the deletion operation.
Non-Reversible Operation
Profile deletion is permanent and cannot be undone. All configuration data, including colors, VSL settings, save progress configurations, and custom settings are permanently lost.
Common Use Cases
Profile Lifecycle Management
Remove profiles that have completed their intended purpose, such as campaign-specific configurations that are no longer relevant or experimental profiles used for testing.
Account Cleanup
Maintain a clean profile inventory by removing unused or duplicate profiles, improving account organization and reducing clutter in profile selection interfaces.
Compliance Requirements
Delete profiles containing outdated tracking configurations or branding elements that no longer comply with current requirements or regulations.
Resource Optimization
Remove unnecessary profiles to optimize account performance and ensure efficient resource utilization across your video delivery infrastructure.
Migration Scenarios
Clean up old profiles when transitioning to new configuration strategies or consolidating multiple profiles into more efficient configurations.
Impact Considerations
Video Player Behavior
Videos currently configured with the deleted profile will lose their custom player settings. Consider updating video configurations to use alternative profiles before deletion to maintain consistent user experiences.
Authentication Requirements
This endpoint requires valid authentication credentials with appropriate permissions to delete profiles within your account. The system enforces strict ownership validation to prevent unauthorized deletions.