> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update List

> Update a subscriber list

Update a subscriber list's name, description, or privacy flag. Only the fields you provide are changed.

## Request

<ParamField path="listId" type="string" required>
  Subscriber list ID.
</ParamField>

<ParamField body="name" type="string">
  New list name.
</ParamField>

<ParamField body="description" type="string">
  New list description. Pass `null` to clear it.
</ParamField>

<ParamField body="isPrivate" type="boolean">
  Set to `true` to keep the list internal. Private lists are omitted from the
  hosted subscriber email preferences/unsubscribe page and cannot be subscribed
  to or unsubscribed from individually there. Set to `false` to expose the
  list's name and description on that page. List privacy does not override a
  subscriber's global unsubscribe. Omit this field to leave the current
  visibility unchanged.
</ParamField>

```bash theme={null}
curl -X PATCH "https://api.sequenzy.com/api/v1/lists/list_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Newsletter Subscribers", "isPrivate": false}'
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "list": {
      "id": "list_abc123",
      "name": "Newsletter Subscribers",
      "description": "Weekly newsletter audience",
      "isPrivate": false,
      "createdAt": "2026-05-20T10:00:00.000Z"
    }
  }
  ```

  ```json 401 theme={null}
  {
    "error": "Invalid API key"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "List not found"
  }
  ```

  ```json 500 theme={null}
  {
    "error": "Failed to update list"
  }
  ```
</ResponseExample>