---
title: "Updates a player."
method: PUT
path: "/1/vod/channel/{channel}/player/{player}"
tags: ["V2 > Player"]
---

# Updates a player.

`PUT /1/vod/channel/{channel}/player/{player}`

## Path parameters

- `channel` integer, required
- `player` integer, required

## Request body

- object
  - `default` boolean
  - `channel_id` integer — <br/>This field must exist on the `channels` database in the `id` column.
  - `name` string, required
  - `description` string
  - `show_controls` boolean
  - `show_progression` boolean
  - `show_audio` boolean
  - `show_duration` boolean
  - `show_fullscreen` boolean
  - `show_default_logo` boolean
  - `show_speed` boolean
  - `default_speed` number — <br/>This field must be present and not empty if the `show_speed` field is equal to any of the following:`1`
  - `is360` boolean
  - `encoding_change_enabled` boolean
  - `encoding_limit` boolean
  - `auto_start` boolean
  - `audio_volume` number
  - `show_replay` boolean
  - `show_loop` boolean
  - `show_related` boolean
  - `play_related` boolean
  - `related_type` string — <br/>This field must be present and not empty if the `play_related` field is equal to any of the following:`1`
  - `width` number
  - `height` number
  - `controlbar_color` string, required
  - `control_color` string, required
  - `control_active_color` string, required
  - `logo_image` string
  - `logo_image_mimetype` string — <br/>This field must be present and not empty only if any of the following fields are present:`logo_image`
  - `logo_anchor` string — <br/>This field must be present and not empty if the `logo_image` field is equal to any of the following:`1`
  - `logo_margin_vertical` number — <br/>This field must be present and not empty if the `logo_image` field is equal to any of the following:`1`
  - `logo_margin_horizontal` number — <br/>This field must be present and not empty if the `logo_image` field is equal to any of the following:`1`
  - `logo_percentage` number — <br/>This field must be present and not empty if the `logo_image` field is equal to any of the following:`1`
  - `show_media_info` boolean
  - `show_media_thumbnail` boolean
  - `media_thumbnail_anchor` string — <br/>This field must be present and not empty if the `show_media_thumbnail` field is equal to any of the following:`1`
  - `enable_facebook` boolean
  - `facebook_back_link` string — <br/>This field must be present and not empty if the `enable_facebook` field is equal to any of the following:`1`<br/>This domain name must have a valid A or AAAA record.
  - `facebook_player_embed` boolean
  - `enable_twitter` boolean
  - `twitter_via` string — <br/>This field must be present and not empty if the `enable_twitter` field is equal to any of the following:`1`
  - `twitter_back_link` string — <br/>This field must be present and not empty if the `enable_twitter` field is equal to any of the following:`1`<br/>This domain name must have a valid A or AAAA record.
  - `twitter_related` string[] — <br/>This field must be present and not empty if the `enable_twitter` field is equal to any of the following:`1`
  - `enable_embed_code` boolean
  - `ads_enabled` boolean
  - `preload_image` string
  - `preload_image_mimetype` string
  - `interrupt_image` string
  - `interrupt_image_mimetype` string — <br/>This field must be present and not empty only if any of the following fields are present:`interrupt_image`
  - `geoip_image` string
  - `geoip_image_mimetype` string — <br/>This field must be present and not empty only if any of the following fields are present:`geoip_image`
  - `restrict_image` string
  - `restrict_image_mimetype` string — <br/>This field must be present and not empty only if any of the following fields are present:`restrict_image`
  - `force_media_ratio` boolean

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` Acfc41a0Player
    - `name` string, required
    - `description` string
    - `show_controls` boolean
    - `show_progression` boolean
    - `show_audio` boolean
    - `show_duration` boolean
    - `show_fullscreen` boolean
    - `show_default_logo` boolean
    - `show_speed` boolean
    - `default_speed` number
    - `is360` boolean
    - `encoding_change_enabled` boolean
    - `encoding_limit` boolean
    - `auto_start` boolean
    - `audio_volume` number
    - `show_replay` boolean
    - `show_loop` boolean
    - `show_related` boolean
    - `play_related` boolean
    - `related_type` string
    - `width` number
    - `height` number
    - `controlbar_color` string, required
    - `control_color` string, required
    - `control_active_color` string, required
    - `logo_image` string
    - `logo_anchor` string
    - `logo_margin_vertical` number
    - `logo_margin_horizontal` number
    - `logo_percentage` number
    - `show_media_info` boolean
    - `show_media_thumbnail` boolean
    - `media_thumbnail_anchor` string
    - `enable_facebook` boolean
    - `facebook_back_link` string
    - `facebook_player_embed` boolean
    - `enable_twitter` boolean
    - `twitter_via` string
    - `twitter_back_link` string
    - `twitter_related` unknown[]
      - unknown
    - `enable_embed_code` boolean
    - `preload_image` string
    - `interrupt_image` string
    - `geoip_image` string
    - `restrict_image` string
    - `chromecast` string
    - `auto_hide_controls` string
    - `show_viewers` string
    - `show_viewers_only_after` string
    - `show_viewers_after` string
    - `time_before_hide_cb` string
    - `force_media_ratio` boolean
    - `ads_enabled` boolean

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)