---
title: "Replace a custom album logo"
method: PATCH
path: "/users/{user_id}/albums/{album_id}/logos/{logo_id}"
tags: ["Albums\\Custom album logos"]
---

# Replace a custom album logo

`PATCH /users/{user_id}/albums/{album_id}/logos/{logo_id}`

## Request

- Base URL: `https://api.vimeo.com`
- URL: `https://api.vimeo.com/users/{user_id}/albums/{album_id}/logos/{logo_id}`
- 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/logos/:logo_id/patch.ts> (a function with typed inputs; its response is checked against the schema)

This method replaces the specified custom album logo with a new image file. For information on how to upload the logo, see our
[Working with Thumbnail Uploads](https://developer.vimeo.com/api/upload/thumbnails) guide, and follow the same steps.

## Path parameters

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

## Request body

- object
  - `active` boolean: Whether to make this the active album logo.

## Response `200`

The custom logo was replaced.

- Picture
  - `active` boolean, required: Whether this picture is the active picture for its parent resource.
  - `link` string: The upload URL for the picture. This field appears when you create the picture resource for the first time.
  - `resource_key` string, required: The picture's resource key string.
  - `sizes` object[], required: An array containing reference information about all available image files.
    - `height` number, nullable, required: The height of the image.
    - `link` string, required: The direct link to the image.
    - `link_with_play_button` string: The direct link to the image with a play button overlay.
    - `width` number, required: The width of the image.
  - `type` 'caution' | 'custom' | 'default', required: The type of the picture: Option descriptions: * `caution` - An image that is appropriate for all ages. * `custom` - A custom image for the video. * `default` - The default image for the video.
  - `uri` string, required: The picture's URI.

## Other responses

- `403`: The authenticated user can't modify this album.
- `404`: No such album exists, or it doesn't contain the specified custom logo.

## Changes

- **2019-01-11** `89b756668a1e`: 3 info
  - api operation id `edit_album_logo` removed and replaced with `replace_album_logo`
  - api tag `Albums\Custom album logos` added
  - api tag `Albums\Custom Logos` removed
- **2018-12-05** `26f856a94041`: 3 info
  - api operation id `replace_album_logo` removed and replaced with `edit_album_logo`
  - api tag `Albums\Custom Logos` added
  - api tag `Albums\Custom album logos` removed

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