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

Get a video profile

Retrieves the details of a previously created video profile. Use the profile_id to identify the profile whose transformation settings you need to inspect. The response includes the profile's name, timestamps, and transformation configuration.

1 parameter
profile_idstringrequired

The unique identifier of the video profile to retrieve.

5 status codes
200Returns the profile's identifier, name, creation and update timestamps, and transformation settings.
created_atintegeroptional
Default:0
namestringoptional
profile_idstringoptional
transformationsobjectoptional
updated_atintegeroptional
Default:0
400Returned when the request is invalid.

One documented failure

  • profile_not_found

    Could not find any video profile with specified profile_id.

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 indicates an invalid request; 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 must identify the profile to retrieve.