Update Player

Designing

PUT

/v1/libraries/{libraryId}/players/{playerId}

Updates the configuration or metadata of a specific video player within a library.
This endpoint allows partial updates, so only the fields provided in the request are modified.

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

🟢200Success

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/players/a7f590b4-3fd7-42a4-82bb-a7cfa6aa9d04' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Default Player Changes",
    "language": "fr",
    "font_family": "Rubik",
    "custom_html_head": "<!-- Custom analytics script -->",
    "custom_html_footer": "<footer>Powered by MyApp</footer>",
    "playback_speeds": [
        0.75,
        0.5,
        1.0,
        1.5,
        2.0
    ],
    "is_beta_enabled": true,
    "is_default": false,
    "enable_resumable_position": true,
    "appearance": {
        "primary_color": "#1D9BF0",
        "caption_font_color": "#FFFFFF",
        "caption_background_color": "#000000",
        "font_size": 14,
        "caption_font_size": 18
    },
    "controls": {
        "backward": false,
        "forward": false,
        "airplay": false,
        "big_play_button": false,
        "captions": true,
        "chromecast": false,
        "current_time": true,
        "duration": true,
        "fullscreen": true,
        "mute": true,
        "picture_in_picture": true,
        "play_pause": true,
        "progress": true,
        "settings": true,
        "volume": true
    }
}'

Response Example

200 - Success

{
    "data": {
        "created_at": "2025-11-10T15:30:28.534221+06:00",
        "updated_at": "2025-11-10T15:40:27.592997825+06:00",
        "created_by": "9ba29736-cc5d-4e1c-85e8-f73849914ae0",
        "updated_by": "9ba29736-cc5d-4e1c-85e8-f73849914ae0",
        "font_family": "Rubik",
        "name": "Default Player Changes",
        "language": "fr",
        "custom_html": "",
        "playback_speeds": [
            0.75,
            0.5,
            1,
            1.5,
            2
        ],
        "appearance": {
            "primary_color": "#1D9BF0",
            "caption_font_color": "#FFFFFF",
            "caption_background_color": "#000000",
            "logo": "",
            "logo_destination_url": "",
            "font_size": 14,
            "caption_font_size": 18
        },
        "controls": {
            "backward": false,
            "forward": false,
            "cast": false,
            "big_play_button": false,
            "captions": true,
            "chapters": false,
            "current_time": true,
            "duration": true,
            "fullscreen": true,
            "mute": true,
            "picture_in_picture": true,
            "play_pause": true,
            "progress": true,
            "settings": true,
            "volume": true,
            "hide_branding": false,
            "preload": false,
            "controls_visible": false,
            "enable_download_button": false,
            "loop": false
        },
        "organization_id": "a7f590b4-3fd7-42a4-82bb-a7cfa6aa9d04",
        "id": "4dbe731e-b3b4-4e6d-b291-3339fa28cc91",
        "library_id": "314221a1-3cbf-4d3c-846e-f6c22bc43064",
        "is_beta_enabled": true,
        "is_default": false,
        "enable_resumable_position": true
    },
    "message": "Player Updated Successfully",
    "success": true
}

Modified at 2025-11-10 13:10:36

Player Details

Delete Player