# List conversations

The inbox: every conversation the person may see, with its participants and latest activity. Start here for anything about messages, replies or who last wrote. Narrow to one record's conversations with `definitionId` (the record page's `id` from its definition, a uuid, not its key) and `rowId` (the record's `id`) together — one without the other is refused.

Access class: `workspace`.

## Endpoint

`GET /v1/comms/conversations`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| body | query | null | No |
| params | query | object | No |
| query | query | object | No |

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "conversations": [
    {
      "account_identifier": "string",
      "contact_identifier": "string",
      "contact_name": "string",
      "contact_role": "string",
      "created_at": "string",
      "id": 1.5,
      "is_archived": true,
      "is_muted": true,
      "is_pinned": true,
      "is_starred": true,
      "last_message_at": "string",
      "last_message_direction": "string",
      "last_message_preview": "string",
      "medium": "string",
      "ownerAccountId": "",
      "records": [
        "string"
      ],
      "unread_count": 1.5,
      "visibility": "string"
    }
  ],
  "total": 1.5
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```