---
title: "Rename a list"
method: PATCH
path: "/lists/list/{listId}"
tags: ["Lists"]
---

# Rename a list

`PATCH /lists/list/{listId}`

## Request

- Base URL: `https://api.emelia.io`
- URL: `https://api.emelia.io/lists/list/{listId}`
- Auth: API key in header `Authorization`

Renames a list. Only `name` can be changed through this route.

## Path parameters

- `listId` string, required

## Request body

- object
  - `name` string, required: New name, trimmed.

## Response `200`

List renamed.

- ListsRenameListResult
  - `success` true, required
  - `_id` string, required
  - `name` string, required

## Other responses

- `400`: Invalid list id, or missing or empty name (note: 400 here, while list creation answers 422 for the same mistake).
- `401`: Missing, unknown or disabled API key, or the account of the key no longer exists. Note the body shape: `error` and `code`, not `message`.
- `404`: The list does not exist or belongs to another account.
- `500`: Unexpected server error. `error`, when present, is a raw internal message: do not parse it. Retry later.

---

[API](https://skmtc.dev/emelia/apis/emelia-api.md) · [All operations](https://skmtc.dev/emelia/apis/emelia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emelia/apis/emelia-api/revisions/8c0cb435f2c4?raw)