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

# Chats

> List and manage instance conversations

Use `chats` to list conversations and apply actions such as archive, mute, pin, and expiration.

For instances, see [Instances and billing](/en/sdk/python/instances-and-billing). For session, see [Session](/en/sdk/python/session).

## Chats

### `client.chats.list(...)`

```python theme={null}
chats = client.chats.list(
    instance_id="VZ...",
    instance_token="instance-token",
    page=1,
    page_size=20,
)
```

**Return:** page `{ page, page_size, total, total_pages, content[] }` with chat metadata per item.

### `client.chats.get(...)`

```python theme={null}
chat = client.chats.get(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
```

**Return:** `InstanceChatMetadata` — `phone`, `jid`, `name`, flags (`archived`, `pinned`, `muted`, etc.) and last message when available.

### `client.chats.archive(...)`

```python theme={null}
client.chats.archive(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
```

**Return:** `{ status: "ok" }`.

### `client.chats.unarchive(...)`

```python theme={null}
client.chats.unarchive(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
```

**Return:** `{ status: "ok" }`.

### `client.chats.mute(...)`

```python theme={null}
client.chats.mute(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
    duration_seconds=3600,
)
```

**Return:** `{ status: "ok" }`.

### `client.chats.unmute(...)`

```python theme={null}
client.chats.unmute(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
```

**Return:** `{ status: "ok" }`.

### `client.chats.pin(...)`

```python theme={null}
client.chats.pin(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
```

**Return:** `{ status: "ok" }`.

### `client.chats.unpin(...)`

```python theme={null}
client.chats.unpin(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
```

**Return:** `{ status: "ok" }`.

### `client.chats.read(...)`

```python theme={null}
client.chats.read(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
```

**Return:** `{ status: "ok" }`.

### `client.chats.unread(...)`

```python theme={null}
client.chats.unread(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
```

**Return:** `{ status: "ok" }`.

### `client.chats.clear(...)`

```python theme={null}
client.chats.clear(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
    delete_media=False,
)
```

**Return:** `{ status: "ok" }`.

### `client.chats.delete(...)`

```python theme={null}
client.chats.delete(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
    delete_media=False,
)
```

**Return:** `{ status: "ok" }`.

### `client.chats.set_expiration(...)`

```python theme={null}
client.chats.set_expiration(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
    expiration="7_DAYS",
)
```

**Return:** `{ status: "ok" }`.

Accepted values for `expiration`: `24_HOURS`, `7_DAYS`, `90_DAYS`, `OFF`.