---
title: "Updates a Todo list by unique identifier"
method: PUT
path: "/lists/{listId}"
tags: ["Lists"]
---

# Updates a Todo list by unique identifier

`PUT /lists/{listId}`

## Path parameters

- `listId` string, required

## Request body

- TodoList — A list of related Todo items
  - `id` string
  - `name` string, required
  - `description` string

## Response `200`

A Todo list result

- TodoList — A list of related Todo items
  - `id` string
  - `name` string, required
  - `description` string

## Other responses

- `400` — Todo list is invalid
- `404` — Todo list not found

## Changes

> 3 revisions in range; 1 could not be searched.

- **2023-01-11** `5eb2c9dd8927` — 1 info
  - added the non-success response with the status `404`
- **2022-03-25** `0da8ac805a39` — 1 info
  - removed the non-success response with the status `404`

[Change history](https://skmtc.dev/azure/apis/simple-todo-api/changes/lists/:listId/put.md)

---

[API](https://skmtc.dev/azure/apis/simple-todo-api.md) · [All operations](https://skmtc.dev/azure/apis/simple-todo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/simple-todo-api/revisions/3276bd2e08f8/schema)