---
title: "Update Playlist"
method: PATCH
path: "/v1/accounts/{{account_id}}/playlists/{{playlist_id}}"
tags: ["Playlists"]
---

# Update Playlist

`PATCH /v1/accounts/{{account_id}}/playlists/{{playlist_id}}`

Updates a playlist for the account

## Path parameters

- `account_id` string, required
- `playlist_id` string, required

## Headers

- `Content-Type` string, required
- `Authorization` string, required

## Request body

- PlaylistInputFields
  - `description` string — playlist description
  - `favorite` boolean — whether playlist is in favorites list
  - `name` string — the playlist name
  - `reference_id` string — the playlist reference id (must be unique within the account)
  - `search` string — search string to retrieve the videos (smart playlists only)
  - `search_syntax` 'v1' | 'v2' — the search syntax used for the search string; see [Managing Playlists](/cms/managing-videos/managing-playlists-using-cms-api.html)
  - `type` 'EXPLICIT' | 'ACTIVATED_OLDEST_TO_NEWEST' | 'ACTIVATED_NEWEST_TO_OLDEST' | 'ALPHABETICAL' | 'PLAYS_TOTAL' | 'PLAYS_TRAILING_WEEK' | 'START_DATE_OLDEST_TO_NEWEST' | 'START_DATE_NEWEST_TO_OLDEST' — the playlist type: EXPLICIT or smart playlist type
  - `video_ids` string[] — array of video ids (EXPLICIT playlists only) - maximum length: 1000

## Response `200`

200

- Playlist
  - `account_id` string — Video Cloud account id
  - `created_at` string, date-time — date/time created
  - `description` string — playlist description
  - `favorite` boolean — whether playlist is in favorites list
  - `id` string — the playlist id
  - `name` string — the playlist name
  - `reference_id` string — the playlist reference id (must be unique within the account)
  - `search` string — search string to retrieve the videos (smart playlists only)
  - `state` 'READY' | 'UPDATING' — Applies to EXPLICIT (manual) playlists only; `UPDATING` means the list is updating its video members and `READY` means that all videos have been added
  - `type` 'EXPLICIT' | 'ACTIVATED_OLDEST_TO_NEWEST' | 'ACTIVATED_NEWEST_TO_OLDEST' | 'ALPHABETICAL' | 'PLAYS_TOTAL' | 'PLAYS_TRAILING_WEEK' | 'START_DATE_OLDEST_TO_NEWEST' | 'START_DATE_NEWEST_TO_OLDEST' — the playlist type: EXPLICIT or smart playlist type
  - `updated_at` string, date-time — date/time last modified
  - `video_ids` string[] — array of video ids (EXPLICIT playlists only)

## Other responses

- `400` — BAD_VALUE: The JSON could not be parsed
- `401` — UNAUTHORIZED: Authentication failed; check to make sure your client credentials were correct for the access token
- `404` — RESOURCE_NOT_FOUND: The api could not find the resource you requested
- `405` — METHOD_NOT_ALLOWED: The HTTP method specified is not allowed for this endpoint
- `409` — REFERENCE_ID_IN_USE: The specified reference id is already in use
- `422` — ILLEGAL_FIELD: Spelling error or use of non-existent field
- `429` — TOO_MANY_REQUESTS: You are submitting too many simultaneous requests or too many requests per second

---

[API](https://skmtc.net/brightcovelearning/apis/brightcove-cms-api-reference.md) · [All operations](https://skmtc.net/brightcovelearning/apis/brightcove-cms-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brightcovelearning/brightcove-cms-api-reference/versions/1b6182a4560a/schema)