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

# Updates a share.

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

## Path parameters

- `channel` integer, required
- `share` integer, required

## Request body

- object
  - `channel_id` integer — <br/>This field must exist on the `channels` database in the `id` column.
  - `target_type` '"vod_media"' | '"vod_playlist"', required
  - `player_id` integer — <br/>This field must exist on the `players` database in the `id` column.
  - `encoding_id` integer — <br/>This field must be present and not empty if the `target_type` field is equal to any of the following:`vod_media`<br/>This field must exist on the `encodings` database in the `id` column.
  - `comment` string
  - `timestamp` number
  - `validity` integer
  - `player_settings` object
    - `width` number
    - `height` number
    - `auto_start` boolean
    - `show_loop` boolean
    - `preload_image` string
    - `preload_image_mimetype` string
    - `force_media_ratio` boolean
    - `show_progression` boolean

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` Acfc41a0Share
    - `player_id` integer
    - `comment` string
    - `timestamp` number
    - `validity` integer
    - `player_settings` unknown[]
      - unknown
    - `presentation_settings` string

---

[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)