Update Transcoding Profile

curl --request PUT \
  --url https://api.tenbyte.io/v1/stream/libraries/{libraryId}/transcoding/profiles/{profileId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Vidinfra Ultra Secure Profile x",
  "description": "4K adaptive bitrate profile with AES encryption, DRM, watermark, and subtitle generation x.",
  "transcoding": {
    "format": [
      "abr"
    ],
    "resolutions": [
      "144p",
      "240p",
      "360p",
      "480p",
      "720p",
      "1080p",
      "1440p"
    ],
    "video_codec": [
      "h265"
    ],
    "per_title_encoding": true,
    "image_overlay": {
      "url": "https://cdn.vidinfra.com/watermark.png",
      "position": "bottom-right",
      "opacity": 0.8,
      "size": {
        "width": 100,
        "height": 60
      },
      "margin": {
        "x": 100,
        "y": 60
      }
    },
    "thumbnail": {
      "mode": "auto",
      "format": "jpeg",
      "count": 6,
      "spritesheet": true
    },
    "generate_subtitles": {
      "audio_language": "en",
      "subtitle_languages": [
        "es",
        "fr"
      ]
    },
    "drm": {
      "enabled": true,
      "widevine": {
        "signing_secret": "YOUR_SECURE_PROXY_SECRET",
        "license_proxy_url": "https://widevine.yourdomain.com/licence/"
      },
      "fairplay": {
        "license_url": "https://license.fairplay.vidinfra.com",
        "certificate_url": "https://yourdomain.com/fairplay.cer",
        "application_service_key": "YOUR_APPLE_SERVICE_KEY",
        "private_key_passphrase": "YOUR_PRIVATE_KEY_PASSPHRASE"
      }
    },
    "basic_drm": true,
    "mp4_access": false,
    "keep_original": false
  }
}
'

{
  "data": {
    "updated_at": "2025-10-16T11:57:16.272724862+06:00",
    "created_at": "2025-10-16T11:04:29.16848Z",
    "created_by": "2fa3fe27-ffcd-470b-becf-83f6f22a93ab",
    "updated_by": "2fa3fe27-ffcd-470b-becf-83f6f22a93ab",
    "name": "Vidinfra Ultra Secure Profile",
    "description": "4K adaptive bitrate profile with AES encryption, DRM, watermark, and subtitle generation.",
    "transcoding": {
      "drm": {
        "widevine": {
          "signing_secret": "YOUR_SECURE_PROXY_SECRET",
          "license_proxy_url": "https://widevine.yourdomain.com/licence/"
        },
        "fairplay": {
          "license_url": "https://license.fairplay.vidinfra.com",
          "certificate_url": "https://yourdomain.com/fairplay.cer",
          "application_service_key": "YOUR_APPLE_SERVICE_KEY",
          "private_key_passphrase": "YOUR_PRIVATE_KEY_PASSPHRASE"
        },
        "enabled": true
      },
      "format": [
        "abr"
      ],
      "generate_subtitles": {
        "audio_language": "en",
        "subtitle_languages": [
          "es",
          "fr"
        ]
      },
      "resolutions": [
        "144p",
        "240p",
        "360p",
        "480p",
        "720p",
        "1080p",
        "1440p",
        "2160p"
      ],
      "video_codec": [
        "h264"
      ],
      "thumbnail": {
        "mode": "auto",
        "format": "jpg",
        "count": 6,
        "spritesheet": true
      },
      "image_overlay": {
        "url": "https://cdn.vidinfra.com/watermark.png",
        "position": "bottom-right",
        "opacity": 0.8,
        "size": {
          "width": 100,
          "height": 60
        },
        "margin": {
          "x": 100,
          "y": 60
        }
      },
      "per_title_encoding": true,
      "basic_drm": true,
      "mp4_access": false,
      "keep_original": false
    },
    "id": "49f644c1-83cc-41cd-a1dd-19291b008ba4",
    "organization_id": "677826f5-1aea-4cba-8973-043cdbc60f35",
    "library_id": "3b06c833-b73c-43c3-8794-a123a0a6ef1d",
    "is_default": false
  },
  "message": "Transcoding profile Updated Successfully",
  "success": true
}

PUT

libraries

{libraryId}

transcoding

profiles

{profileId}

Update Transcoding Profile

curl --request PUT \
  --url https://api.tenbyte.io/v1/stream/libraries/{libraryId}/transcoding/profiles/{profileId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Vidinfra Ultra Secure Profile x",
  "description": "4K adaptive bitrate profile with AES encryption, DRM, watermark, and subtitle generation x.",
  "transcoding": {
    "format": [
      "abr"
    ],
    "resolutions": [
      "144p",
      "240p",
      "360p",
      "480p",
      "720p",
      "1080p",
      "1440p"
    ],
    "video_codec": [
      "h265"
    ],
    "per_title_encoding": true,
    "image_overlay": {
      "url": "https://cdn.vidinfra.com/watermark.png",
      "position": "bottom-right",
      "opacity": 0.8,
      "size": {
        "width": 100,
        "height": 60
      },
      "margin": {
        "x": 100,
        "y": 60
      }
    },
    "thumbnail": {
      "mode": "auto",
      "format": "jpeg",
      "count": 6,
      "spritesheet": true
    },
    "generate_subtitles": {
      "audio_language": "en",
      "subtitle_languages": [
        "es",
        "fr"
      ]
    },
    "drm": {
      "enabled": true,
      "widevine": {
        "signing_secret": "YOUR_SECURE_PROXY_SECRET",
        "license_proxy_url": "https://widevine.yourdomain.com/licence/"
      },
      "fairplay": {
        "license_url": "https://license.fairplay.vidinfra.com",
        "certificate_url": "https://yourdomain.com/fairplay.cer",
        "application_service_key": "YOUR_APPLE_SERVICE_KEY",
        "private_key_passphrase": "YOUR_PRIVATE_KEY_PASSPHRASE"
      }
    },
    "basic_drm": true,
    "mp4_access": false,
    "keep_original": false
  }
}
'

{
  "data": {
    "updated_at": "2025-10-16T11:57:16.272724862+06:00",
    "created_at": "2025-10-16T11:04:29.16848Z",
    "created_by": "2fa3fe27-ffcd-470b-becf-83f6f22a93ab",
    "updated_by": "2fa3fe27-ffcd-470b-becf-83f6f22a93ab",
    "name": "Vidinfra Ultra Secure Profile",
    "description": "4K adaptive bitrate profile with AES encryption, DRM, watermark, and subtitle generation.",
    "transcoding": {
      "drm": {
        "widevine": {
          "signing_secret": "YOUR_SECURE_PROXY_SECRET",
          "license_proxy_url": "https://widevine.yourdomain.com/licence/"
        },
        "fairplay": {
          "license_url": "https://license.fairplay.vidinfra.com",
          "certificate_url": "https://yourdomain.com/fairplay.cer",
          "application_service_key": "YOUR_APPLE_SERVICE_KEY",
          "private_key_passphrase": "YOUR_PRIVATE_KEY_PASSPHRASE"
        },
        "enabled": true
      },
      "format": [
        "abr"
      ],
      "generate_subtitles": {
        "audio_language": "en",
        "subtitle_languages": [
          "es",
          "fr"
        ]
      },
      "resolutions": [
        "144p",
        "240p",
        "360p",
        "480p",
        "720p",
        "1080p",
        "1440p",
        "2160p"
      ],
      "video_codec": [
        "h264"
      ],
      "thumbnail": {
        "mode": "auto",
        "format": "jpg",
        "count": 6,
        "spritesheet": true
      },
      "image_overlay": {
        "url": "https://cdn.vidinfra.com/watermark.png",
        "position": "bottom-right",
        "opacity": 0.8,
        "size": {
          "width": 100,
          "height": 60
        },
        "margin": {
          "x": 100,
          "y": 60
        }
      },
      "per_title_encoding": true,
      "basic_drm": true,
      "mp4_access": false,
      "keep_original": false
    },
    "id": "49f644c1-83cc-41cd-a1dd-19291b008ba4",
    "organization_id": "677826f5-1aea-4cba-8973-043cdbc60f35",
    "library_id": "3b06c833-b73c-43c3-8794-a123a0a6ef1d",
    "is_default": false
  },
  "message": "Transcoding profile Updated Successfully",
  "success": true
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

libraryId

string

required

Unique identifier of the library.

profileId

string

required

Unique identifier of the targeted transcoding profile resource.

Body

application/json

name

string

required

The name of the transcoding profile used to identify it within the library.

transcoding

object

required

Transcoding property object.

Show child attributes

transcoding.format

string[]

required

Output container formats to generate (e.g., hls, dash).

transcoding.resolutions

string[]

required

Video resolutions to produce (e.g., 720p, 1080p, 4k).

transcoding.video_codec

string[]

required

List of video codecs to use during encoding (e.g., h264).

transcoding.image_overlay

object

required

Transcoding image overlay object.

Show child attributes

transcoding.image_overlay.url

string

required

URL of the image to overlay (e.g., watermark or logo).

transcoding.image_overlay.position

string

required

Position of the overlay image on the video (e.g., top-right, bottom-left).

transcoding.image_overlay.opacity

number

Transparency level of the overlay image (0–1).

transcoding.image_overlay.size

object

Show child attributes

transcoding.image_overlay.size.width

integer

required

Width of the overlay image in pixels.

transcoding.image_overlay.size.height

integer

required

Height of the overlay image in pixels.

transcoding.image_overlay.margin

object

Show child attributes

transcoding.image_overlay.margin.x

integer

required

Horizontal margin offset for the overlay position.

transcoding.image_overlay.margin.y

integer

required

Vertical margin offset for the overlay position.

transcoding.per_title_encoding

boolean

Enables per-title encoding optimization to improve quality and bitrate efficiency. Default value is true.

transcoding.thumbnail

object

Transcoding thumbnails object.

Show child attributes

transcoding.thumbnail.mode

string

required

Thumbnail generation mode.

transcoding.thumbnail.format

string

required

Output format for thumbnails (e.g., jpg, webp).

transcoding.thumbnail.count

integer

required

Number of thumbnails to generate.

transcoding.thumbnail.spritesheet

boolean

required

Whether to generate a spritesheet containing multiple thumbnails.

transcoding.generate_subtitles

object

Transcoding subtitle object.

Show child attributes

transcoding.generate_subtitles.audio_language

string

required

Source audio language for auto-generated subtitles.

transcoding.generate_subtitles.subtitle_languages

string[]

required

Target subtitle languages to generate (e.g., ["en", "es"]).

transcoding.drm

object

Transcoding DRM object.

Show child attributes

transcoding.drm.enabled

boolean

required

Enables Digital Rights Management (DRM) for protected playback.

transcoding.drm.widevine

object

required

Show child attributes

transcoding.drm.widevine.signing_secret

string

required

Secret key used to sign Widevine DRM licenses.

transcoding.drm.widevine.license_proxy_url

string

required

URL of the Widevine license proxy server.

transcoding.drm.fairplay

object

required

Show child attributes

transcoding.drm.fairplay.license_url

string

required

License server URL for FairPlay DRM.

transcoding.drm.fairplay.certificate_url

string

required

Certificate URL for FairPlay DRM authorization.

transcoding.drm.fairplay.application_service_key

string

required

Application key used for FairPlay authentication.

transcoding.drm.fairplay.private_key_passphrase

string

required

Passphrase for the FairPlay private key.

transcoding.basic_drm

boolean

Enables a simplified DRM protection mechanism.

transcoding.mp4_access

boolean

Allows direct download or playback of MP4 files.

transcoding.keep_original

boolean

Keeps the original source file after transcoding completes.

description

string

Short summary describing the purpose or usage of this profile.

Response

data

object

required

Show child attributes

data.updated_at

string

required

data.created_at

string

required

data.created_by

string

required

data.updated_by

string

required

data.name

string

required

data.description

string

required

data.transcoding

object

required

Show child attributes

data.transcoding.drm

object

required

Show child attributes

data.transcoding.drm.widevine

object

required

Show child attributes

data.transcoding.drm.widevine.signing_secret

string

required

data.transcoding.drm.widevine.license_proxy_url

string

required

data.transcoding.drm.fairplay

object

required

Show child attributes

data.transcoding.drm.fairplay.license_url

string

required

data.transcoding.drm.fairplay.certificate_url

string

required

data.transcoding.drm.fairplay.application_service_key

string

required

data.transcoding.drm.fairplay.private_key_passphrase

string

required

data.transcoding.drm.enabled

boolean

required

data.transcoding.format

string[]

required

data.transcoding.generate_subtitles

object

required

Show child attributes

data.transcoding.generate_subtitles.audio_language

string

required

data.transcoding.generate_subtitles.subtitle_languages

string[]

required

data.transcoding.resolutions

string[]

required

data.transcoding.video_codec

string[]

required

data.transcoding.thumbnail

object

required

Show child attributes

data.transcoding.thumbnail.mode

string

required

data.transcoding.thumbnail.format

string

required

data.transcoding.thumbnail.count

integer

required

data.transcoding.thumbnail.spritesheet

boolean

required

data.transcoding.image_overlay

object

required

Show child attributes

data.transcoding.image_overlay.url

string

required

data.transcoding.image_overlay.position

string

required

data.transcoding.image_overlay.opacity

number

required

data.transcoding.image_overlay.size

object

required

Show child attributes

data.transcoding.image_overlay.size.width

integer

required

data.transcoding.image_overlay.size.height

integer

required

data.transcoding.image_overlay.margin

object

required

Show child attributes

data.transcoding.image_overlay.margin.x

integer

required

data.transcoding.image_overlay.margin.y

integer

required

data.transcoding.per_title_encoding

boolean

required

data.transcoding.basic_drm

boolean

required

data.transcoding.mp4_access

boolean

required

data.transcoding.keep_original

boolean

required

data.id

string

required

data.organization_id

string

required

data.library_id

string

required

data.is_default

boolean

required

message

string

required

success

boolean

required

Get Transcoding Profile Delete Transcoding Profile

⌘I

API documentation

CDN

Vidinfra

Authorizations

Path Parameters

Body

Response