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

# Conversations API

List, create, read, and update support conversations.

# Conversations API

Conversations are scoped to projects.

```txt
https://api.rogeriq.com/api/v1/projects/:projectId/conversations
```

## List Conversations

```bash
curl "https://api.rogeriq.com/api/v1/projects/prj_123/conversations?status=open&limit=25" \
  -H "Authorization: Bearer riq_your_key"
```

Query parameters:

| Parameter | Description |
| --- | --- |
| `status` | Filter by status. |
| `priority` | Filter by priority. |
| `channel` | Filter by channel. |
| `assigned_to` | Filter by assignee. |
| `contact_id` | Filter by linked contact. |
| `cursor` | Pagination cursor. |
| `limit` | Page size, up to 100. |
| `sort` | Sort field. |
| `order` | `asc` or `desc`. |

## Create Conversation

```bash
curl https://api.rogeriq.com/api/v1/projects/prj_123/conversations \
  -H "Authorization: Bearer riq_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Refund question",
    "contact_id": "ct_123",
    "channel": "api",
    "priority": "normal",
    "tags": ["billing"]
  }'
```

## Get Conversation

```bash
curl https://api.rogeriq.com/api/v1/projects/prj_123/conversations/conv_123 \
  -H "Authorization: Bearer riq_your_key"
```

## Update Conversation

```bash
curl -X PATCH https://api.rogeriq.com/api/v1/projects/prj_123/conversations/conv_123 \
  -H "Authorization: Bearer riq_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "resolved",
    "priority": "normal",
    "tags": ["billing", "refund"]
  }'
```

## Status and Priority

Statuses include `open`, `pending`, `snoozed`, `resolved`, `closed`, `spam`, and `deleted`.

Priorities include `low`, `normal`, `high`, and `urgent`.