---
title: "Update a list's name, description, or archived status (e.g. list_id 'senior-clinical-belgium'). Fails with 'not found' i"
method: PATCH
path: "/api/v1/lists/{list_id}"
tags: ["lists"]
---

# Update a list's name, description, or archived status (e.g. list_id 'senior-clinical-belgium'). Fails with 'not found' i

`PATCH /api/v1/lists/{list_id}`

## Request

- Base URL: `https://crispy.sh`
- URL: `https://crispy.sh/api/v1/lists/{list_id}`
- Auth: HTTP bearer

## Path parameters

- `list_id` string, required

## Request body

- object
  - `name` string: New list name
  - `description` string: New list description
  - `archived` boolean: Set to true to archive, false to unarchive

## Response `200`

Success

## Other responses

- `401`: Missing or expired API key
- `403`: Insufficient key scope or permission denied
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/crispy/apis/crispy-rest-api.md) · [All operations](https://skmtc.dev/crispy/apis/crispy-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crispy/apis/crispy-rest-api/revisions/6bed0974d9ce?raw)