Skip to main content

Video Profile

Complete API reference for video profile

Gumlet provides the functionality of creating multiple video assets using the same set of parameters. A Video profile is a set of parameters that can be referenced/used while creating a video as a single parameter.

curl -L -X POST '' \-H 'Authorization: Bearer <YOUR API KEY>' \-H 'Content-Type: application/json' \-d '{    "input":"",    "source_id": "5f462c1561cf8a766464ffc4",    "profile_id": "5feaf9a22e3cb37e8417174e"}'

POST Create Profile#

A video profile refers to a set of video asset parameter which can be stored and later used to create a video asset.

Body Parameters


Profile name or identifier.

Required: true


Transcode and deliver the asset in the requested format. The options can be one of mp4, HLS, MPEG-DASH, mkv, and webm.

Required: true

descriptionstringSmall text describing the profile.

Video Profile supports all video asset create request body parameters except input and source_id(which are individual to an asset).

curl -L -X POST '' \-H 'Authorization: Bearer <YOUR API KEY>' \-H 'Content-Type: application/json' \-d '{    "name": "Gumlet Video Profile-1"    "format": "hls",    "text_overlay": {        "text": "Gumlet",        "horizontal_margin": "10%",        "vertical_margin": "10%",        "vertical_align": "top",        "horizontal_align": "left",        "color": "black",        "font_size": "45",        "box": true,        "box_color": "white",        "box_border": "10"    }}'

POST Update Profile#

Update an existing profile. Settings provided in body parameters will only be updated in the existing profile. profile_id is the required parameter for updating a video profile.

curl -L -X POST '' \-H 'Authorization: Bearer <YOUR API KEY>' \-H 'Content-Type: application/json' \-d '{    "image_overlay": {        "url": "",        "height": "10%",        "width": "10%",        "horizontal_align": "left",        "horizontal_margin": "5%",        "vertical_align": "top",        "vertical_margin": "5%"    }}'

GET Profile Status#

This endpoint retrieves the details of a video profile that has previously been created. Given the unique profile_id, Gumlet will return the corresponding profile status.

Path Parameters#

profile_idstringGumlet video profile id.
curl -L -X GET '' \-H 'Authorization: Bearer <YOUR API KEY>'

GET List Profiles#

This endpoint retrieves the details of all profiles that have previously been created.

Query Parameters

offsetintegerOffset value for a paginated list of profiles. Can be zero for the first time andcurrent_offsetvalue received from the last request afterward.

Page size for the paginated list.

Default: 10

curl -L -X GET '' \-H 'Authorization: Bearer <YOUR API KEY>'

DELETE Delete Profile#

This endpoint removes a profile given its unique profile id. The profile will be removed but assets created using the profile will remain as it is.

Path Parameters#

profile_idstringprofile id for the previously created profile.
curl -L -X DELETE '' \-H 'Authorization: Bearer <YOUR API KEY>'