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

# Discover and follow channels

> Fetch channel metadata, search the directory, and follow or mute channels.

## Subscribed channels

```http theme={null}
GET /api/v1/sessions/{sessionId}/newsletters/subscribed
Authorization: Bearer <api_key>
```

## Fetch metadata

```http theme={null}
GET /api/v1/sessions/{sessionId}/newsletters/{newsletterJid}
Authorization: Bearer <api_key>
```

Fetch by invite code:

```http theme={null}
POST /api/v1/sessions/{sessionId}/newsletters/invite
Authorization: Bearer <api_key>
Content-Type: application/json
```

```json theme={null}
{ "inviteCode": "AbCdEf" }
```

## Search and recommendations

```http theme={null}
POST /api/v1/sessions/{sessionId}/newsletters/search
POST /api/v1/sessions/{sessionId}/newsletters/recommended
POST /api/v1/sessions/{sessionId}/newsletters/similar
Authorization: Bearer <api_key>
Content-Type: application/json
```

```json theme={null}
{
  "searchText": "product updates",
  "limit": 20,
  "categories": ["business"]
}
```

For similar channels, include `newsletterJid`.

## Directory helpers

```http theme={null}
POST /api/v1/sessions/{sessionId}/newsletters/directory
POST /api/v1/sessions/{sessionId}/newsletters/categories-preview
POST /api/v1/sessions/{sessionId}/newsletters/domains-previewable
POST /api/v1/sessions/{sessionId}/newsletters/dehydrated
Authorization: Bearer <api_key>
Content-Type: application/json
```

Directory list example:

```json theme={null}
{
  "view": "POPULAR",
  "countryCodes": ["US"],
  "limit": 20
}
```

## Follow, unfollow, mute, or unmute

```http theme={null}
POST /api/v1/sessions/{sessionId}/newsletters/{newsletterJid}/follow
Authorization: Bearer <api_key>
Content-Type: application/json
```

```json theme={null}
{ "action": "follow" }
```

`action` can be `follow`, `unfollow`, `mute`, or `unmute`.
