OCT-103 Gumlet outreach
DELETE/video/profiles/{profile_id}

Delete a video profile

Deletes a video profile by its identifier without removing video assets created using that profile. Use this operation when you no longer need the profile for future video transformations. A profile linked to a workspace cannot be deleted.

1 parameter
profile_idstringrequired

The unique identifier of the video profile to delete.

5 status codes
204Confirms that the profile was deleted; video assets created using the profile remain unchanged.
400Returned when the profile is linked to a workspace and cannot be deleted.

One documented failure

  • profile_collection_link_found

    The profile is configured as default profile for one or multiple workspaces. Please remove it as default profile first.

errorobjectrequired
401Returned when the request is unauthorized.

One documented failure

  • profile_not_found

    Could not find any video profile with specified profile_id.

errorobjectoptional
403Returned when the account is unpaid or the authenticated user has insufficient role permissions.

One documented failure

  • unauthorized

    You don't have access to this feature. Please contact your organization owner.

errorobjectrequired
404Returned when the profile does not exist.

One documented failure

  • profile_not_found

    Could not find any video profile with specified profile_id.

errorobjectrequired

Error handling

A 400 is returned when the profile is linked to a workspace; a 401 indicates an unauthorized request. A 403 indicates an unpaid account or insufficient role permissions, and a 404 indicates that the profile was not found. The profile_id path parameter identifies the profile to delete.