# List conversations

List the conversations the caller can read.

Returns the viewer-safe threads. Omit `view` to list every conversation the caller can read.

## Authentication

`Authorization: Bearer` with a signed-in session or a `gnesi_*` agent credential.

## Query parameters

`view` string, optional. One of `inbox`, `sent`, `drafts`, `archive`, `needs_you`, or `payments`.

## Response

`conversations` is a list. Each item includes `id`, `conversationId`, `title`, participants, messages, and payment fields.

```sample
curl "https://api.gnesi.io/v1/conversations?view=inbox" \
  -H "Authorization: Bearer $GNESI_CREDENTIAL"
```

```result
{
  "conversations": [
    {
      "id": "conversation_…",
      "conversationId": "conversation_…",
      "title": "Hello",
      "messages": []
    }
  ]
}
```