Conversations API
List, create, read, and update support conversations.
Conversations API
Conversations are scoped to projects.
txthttps://api.rogeriq.com/api/v1/projects/:projectId/conversations
List Conversations
bashcurl "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
bashcurl 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
bashcurl https://api.rogeriq.com/api/v1/projects/prj_123/conversations/conv_123 \ -H "Authorization: Bearer riq_your_key"
Update Conversation
bashcurl -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.