---
title: "Add a version to a video"
method: POST
path: "/videos/{video_id}/versions"
tags: ["Videos\\Versions"]
---

# Add a version to a video

`POST /videos/{video_id}/versions`

This method adds a version to the specified video.

## Path parameters

- `video_id` number, required

## Response `201`

The version was added.

## Other responses

- `400` — Error code 2204: The request input contains invalid versions data.
- `403` — Error code 3427: The authenticated user can't edit the video.
- `404` — * Error code 5011: An upload isn't associated with this version. * Error code 5012: A video isn't associated with this upload. * Error code 5013: The endpoint isn't available, because the specified version of the API is less than 3.4 and **upload.approach** isn't `tus`.

## Changes

- **2019-02-01** `ff2c9d773e0b` — 1 info
  - added the new optional request property `upload/redirect_url`
- **2019-01-11** `89b756668a1e` — 1 breaking
  - the response property `filesize` became nullable for the status `201`
- **2018-12-05** `26f856a94041` — 1 warning
  - removed the request property `upload/redirect_url`

[Change history](https://skmtc.dev/vimeo/apis/vimeo-api/changes/videos/:video_id/versions/post.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)