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

# Update List

## `PUT` a List

`PUT` `/user-api/v1/lists/:id`

### Headers

| **Header**          | **Value**           |
| ------------------- | ------------------- |
| `Content-Type`      | `application/json`  |
| `x-rolodex-api-key` | `f1e2d3c4b5a697...` |

### Path Parameters

<ParamField path="id" type="string">
  List ID
</ParamField>

### Query Parameters

<ParamField path="include" type="string">
  Related data to include: `contacts`, `companies`
</ParamField>

### Endpoint Example

`PUT` `/user-api/v1/lists/list_99999?include=contacts`

<Note>
  Relationship fields (`contacts`, `companies`) are replaced entirely with the provided values. To add to existing relationships, include all current values plus new ones. The type field cannot be updated after creation.
</Note>

### Request

```json theme={null}
{
  "name": "Premium VIP Contacts",
  "description": "Updated description for our premium contacts",
  "contacts": [
    "contact_123",
    "contact_999"
  ]
}
```

### Response

```json theme={null}
{
  "data": {
    "id": "list_99999",
    "name": "Premium VIP Contacts",
    "type": "CONTACT",
    "description": "Updated description for our premium contacts",
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T12:45:00Z"
  }
}
```