# Edit one of your Lists

> Changes the name, description or visibility of a List the user owns.

`PATCH /account/lists/{id}` on `https://api.mediux.io`

Send only the fields you change. Making a List private ends its subscriptions. A change is all or nothing. Making a List public or private takes effect at once; other changes to a Public List can take up to an hour to show on the public List routes.

## Authorization

OAuth 2 bearer token in the `Authorization` header. Required permission: `lists:write`.

## Parameters

- `id` (path, string, required): The List's ID (a lowercase UUID). A List the user neither owns nor subscribes to, or a malformed ID, is `404` `list.notFound`.

## Request body (`application/json`)

- `name` (string)
- `description` (string, nullable)
- `isPublic` (boolean)

## Responses

### 200

The List.

- `data` (object, required)

### 400

The request is malformed or failed validation. Inspect `error.code` and `error.issues`.

### 401

The access token is missing (`auth.required`), or invalid, expired or revoked (`auth.invalidToken`).

### 403

The token lacks the required App Permission (`auth.insufficientScope`, with `details.required`), or the account or connection may not do this (`auth.forbidden`).

### 404

The resource does not exist or is not the user's.

### 413

The body exceeds the allowed size.

### 415

The `Content-Type` is not `application/json`.

### 429

Too many requests. Wait the `Retry-After` seconds before trying again.

### 503

Temporarily unavailable. Check the outcome before retrying a write.

## Example response (200)

```json
{
  "data": {
    "kind": "assetList",
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "name": "name",
    "description": "A short description.",
    "owner": {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "username": "username"
    },
    "itemCount": 0,
    "subscriberCount": 0,
    "createdAt": "createdAt",
    "updatedAt": "updatedAt",
    "items": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "extension": "extension",
        "slot": "poster",
        "entity": {
          "kind": "show",
          "id": 1
        },
        "language": "en",
        "edition": "theatricalCut",
        "width": 1,
        "height": 1,
        "fileSize": 0,
        "set": {
          "kind": "showSet",
          "id": 1
        },
        "creator": {
          "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
          "username": "username"
        },
        "createdAt": "createdAt",
        "updatedAt": "updatedAt"
      }
    ]
  }
}
```
