API Reference

Delete profile

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.

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