---
title: "Rename or reorder a playlist group"
method: PATCH
path: "/v1/playlist-groups/{id}"
tags: ["Playlist Groups"]
---

# Rename or reorder a playlist group

`PATCH /v1/playlist-groups/{id}`

Rename a playlist group and/or move it to a position in its sidebar section (0 = top)

## Path parameters

- `id` string, required — Unique playlist group identifier

## Request body

- UpdatePlaylistGroupRequest — Request to rename and/or reorder a playlist group
  - `emoji` string — Unicode emoji character for the group
  - `name` string — New playlist group name
  - `position` integer — 0-based position in the sidebar section (0 = top), counted across groups and ungrouped playlists

## Response `200`

OK

- PlaylistGroupResponse — A single playlist group
  - `group` PlaylistGroup, required — A sidebar group that playlists can be organized into. Personal groups are only visible to you; org groups are shared with the whole workspace.
    - `emoji` string, required — Unicode emoji character for the group, empty if unset
    - `id` string, required — Unique playlist group identifier
    - `name` string, required — Playlist group name
    - `visibility` 'org' | 'personal', required — Visibility: org (shared sidebar group for the entire organization) or personal (only visible to you)

## Other responses

- `400` — The request was malformed or contained invalid parameters.
- `401` — Authentication is required. Provide a valid API key.
- `403` — You don't have permission to access this resource.
- `404` — The requested resource was not found.
- `429` — You have exceeded the rate limit. Please slow down.
- `500` — An unexpected error occurred
- `501` — The requested operation is not implemented.

---

[API](https://skmtc.dev/withchima/apis/tella-public-api.md) · [All operations](https://skmtc.dev/withchima/apis/tella-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withchima/tella-public-api/revisions/cd69045c703a/schema)