---
title: "Replace all the videos in an album"
method: PUT
path: "/users/{user_id}/albums/{album_id}/videos"
tags: ["Albums\\Album videos"]
---

# Replace all the videos in an album

`PUT /users/{user_id}/albums/{album_id}/videos`

## Request

- Base URL: `https://api.vimeo.com`
- URL: `https://api.vimeo.com/users/{user_id}/albums/{album_id}/videos`
- Auth: OAuth 2
  - Authorization code: `/oauth/authorize`, token URL `/oauth/access_token`
  - Client credentials, token URL `/oauth/authorize/client`
  - Scopes: `edit`
- TypeScript: <https://skmtc.dev/vimeo/apis/vimeo-api/docs/users/:user_id/albums/:album_id/videos/put.ts> (a function with typed inputs; its response is checked against the schema)

This method replaces all the existing videos in an album with one or more videos.

## Path parameters

- `album_id` number, required
- `user_id` number, required

## Request body

- object
  - `videos` string, required: A comma-separated list of video URIs.

## Response `201`

The videos were added.

## Other responses

- `403`: The authenticated user can't add videos to albums.
- `404`: No such album exists.

## Changes

- **2019-01-11** `89b756668a1e`: 3 info
  - api operation id `add_videos_to_album` removed and replaced with `replace_videos_in_album`
  - api tag `Albums\Album videos` added
  - api tag `Albums\Album Videos` removed
- **2018-12-05** `26f856a94041`: 3 info
  - api operation id `replace_videos_in_album` removed and replaced with `add_videos_to_album`
  - api tag `Albums\Album Videos` added
  - api tag `Albums\Album videos` removed

[Operation history](https://skmtc.dev/vimeo/apis/vimeo-api/changes/users/:user_id/albums/:album_id/videos/put.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.dev/vimeo/apis/vimeo-api/revisions/ea882e0224a4?raw)