Update Transcoding Profile

Developing

PUT

/v1/libraries/{libraryId}/transcoding/profiles/{profileId}

Retrieve detailed configuration of a profile

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Not Found

🟠422Unprocessable Entity

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api-staging.tenbyte.io/v1/v1/libraries/314221a1-3cbf-4d3c-846e-f6c22bc43064/transcoding/profiles/a7f590b4-3fd7-42a4-82bb-a7cfa6aa9d04' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "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
  }
}'

Response Example

200 - Success

{
    "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
}

Modified at 2025-11-10 13:09:31

Get Transcoding Profile

Mark Default Transcoding Profile