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

# Edit a video

`PATCH /videos/{video_id}`

## Path parameters

- `video_id` number, required

## Response `200`

The video was edited.

## Other responses

- `400` — A parameter is invalid.
- `403` — There are four ways that this status code can be encountered: * The authenticated user does not own the video. * The `privacy` field is `disable` and the authenticated user cannot set extra embed options. * The `privacy` field is `contacts` and the authenticated user cannot follow creators. * The authenticated user has an opted-out PRO account and `privacy.view` is `users`, `password`, `nobody`, or `public`.

## Changes

- **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/0aaf609c3dbf/schema)