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://loading/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": {}
}

{
  "_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`