List inbox conversations

GET/api/inbox/conversations

Returns render-focused inbox conversations for the current workspace.

Query Parameters

limit?|

Maximum number of results to return.

Example30

cursor?|

cursor.

Example"eyJ2IjoxLCJvZmZzZXQiOjMwfQ"

q?|

Example"coca"

status?|

Current status value.

Example"open"

Response Body

`application/json`

curl -X GET "https://example.com/api/inbox/conversations"

{  "items": [    {      "id": "conv_123",      "title": "Coca-Cola Andina",      "subtitle": "Maria Jose Rivas",      "channel": "email",      "channelLabel": "WhatsApp",      "status": "open",      "preview": "Need updated pricing for PO-88421.",      "customerName": "Coca-Cola Andina",      "lastMessageAt": "2026-04-01T12:05:00.000Z",      "unreadCount": 0,      "canReply": true,      "components": [        {          "id": "string",          "type": "object_reference",          "title": "string",          "subtitle": "string",          "href": "string",          "data": {}        }      ],      "stage": "string",      "priority": "string",      "requestType": "string",      "sla": "string",      "purchaseSystem": "string",      "purchaseReference": "string",      "tags": [        {          "id": "string",          "label": "string",          "tone": "neutral"        }      ]    }  ],  "pageInfo": {    "nextCursor": "eyJ2IjoxLCJvZmZzZXQiOjMwfQ",    "hasNextPage": false  }}

{  "_tag": "ApiBadRequestError",  "code": "PRICE_IMPORT_DUPLICATE_SKUS",  "message": "The request payload is invalid.",  "description": "Remove duplicate SKU rows before importing the file.",  "details": null}

{  "_tag": "Unauthorized"}

{  "_tag": "ApiForbiddenError",  "message": "You do not have permission to perform this action."}

{  "_tag": "ApiNotFoundError",  "message": "The requested resource was not found."}

{  "_tag": "ApiConflictError",  "message": "A resource with this handle already exists."}

{  "_tag": "ApiUnprocessableEntityError",  "message": "The order cannot be submitted without items."}

{  "_tag": "ServiceUnavailable"}

{  "_tag": "ApiTimeoutError",  "message": "The upstream operation timed out."}

List inbox conversations

Query Parameters

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

409application/json

422application/json

503application/json

504application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`