---
title: "Edit a video"
method: PATCH
path: "/videos/{video_id}"
tags: ["Videos\\Essentials"]
---

# Edit a video

`PATCH /videos/{video_id}`

This method edits the specified video.

## Path parameters

- `video_id` number, required

## Response `200`

The video was edited.

## Other responses

- `400` — A parameter is invalid.
- `403` — * The authenticated user doesn't own the video. * The **privacy** field is `disable`, and the authenticated user can't set extra embed options. * The **privacy** field is `contacts`, and the authenticated user can't follow creators. * The authenticated user has an opted-out Pro account, and **privacy.view** is `users`, `password`, `nobody`, or `public`.

## Changes

> 13 revisions in range; 1 could not be searched.

- **2019-04-12** `80428f626f3e` — 1 warning
  - removed the request property `ratings`
- **2019-03-29** `d66f7a79837f` — 1 info
  - added the required property `type` to the response with the `200` status
- **2019-02-22** `0aaf609c3dbf` — 1 info
  - added the optional property `password` to the response with the `200` status
- **2019-01-11** `89b756668a1e` — 2 info
  - added `#/components/schemas/project` to the `parent_folder` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/folder` from the `parent_folder` response property `allOf` list for the response status `200`
- **2018-12-05** `26f856a94041` — 3 breaking, 2 warning, 3 info
  - removed the required property `metadata/connections/available_albums` from the response with the `200` status
  - removed the required property `metadata/connections/available_channels` from the response with the `200` status
  - removed the required property `type` from the response with the `200` status
  - removed the optional property `metadata/connections/versions/resource_key` from the response with the `200` status
  - …4 more

[Change history](https://skmtc.dev/vimeo/apis/vimeo-api/changes/videos/:video_id/patch.md)

---

[API](https://skmtc.dev/vimeo/apis/vimeo-api.md) · [All operations](https://skmtc.dev/vimeo/apis/vimeo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vimeo/vimeo-api/revisions/ea882e0224a4/schema)