---
title: "List conversations"
method: GET
path: "/internal/conversations"
tags: ["Others"]
---

# List conversations

`GET /internal/conversations`

List conversations for a managed project

## Query parameters

- `projectId` string, required — The unique identifier of the project
- `query` string
- `status` 'open' | 'pending' | 'closed'
- `userId` string — The unique identifier of the user
- `limit` string
- `offset` string

## Response `200`

Successful response

- object
  - `conversations` object[], required
    - `conversationId` string, required
    - `userId` string
    - `teamId` string
    - `userDisplayName` string
    - `userPrimaryEmail` string
    - `userProfileImageUrl` string
    - `subject` string, required
    - `status` 'open' | 'pending' | 'closed', required
    - `priority` 'low' | 'normal' | 'high' | 'urgent', required
    - `source` 'manual' | 'chat' | 'email' | 'api', required
    - `lastMessageType` 'message' | 'internal-note' | 'status-change', required
    - `preview` string
    - `lastActivityAt` string, required
    - `metadata` object, required
      - `assignedToUserId` string
      - `assignedToDisplayName` string
      - `tags` string[], required
      - `firstResponseDueAt` string
      - `firstResponseAt` string
      - `nextResponseDueAt` string
      - `lastCustomerReplyAt` string
      - `lastAgentReplyAt` string
    - `createdAt` string
    - `updatedAt` string
    - `lastMessageAt` string
    - `lastInboundAt` string
    - `lastOutboundAt` string
    - `closedAt` string
    - `recordMetadata` object
  - `hasMore` boolean, required

## Changes

- **2026-05-15** `f135fd8ca8b4` — 1 breaking, 14 warning, 3 info
  - the `query` request parameter `status` was restricted to a list of enum values
  - added the new `api` enum value to the `conversations/items/source` response property for the response status `200`
  - added the new `chat` enum value to the `conversations/items/source` response property for the response status `200`
  - added the new `closed` enum value to the `conversations/items/status` response property for the response status `200`
  - …14 more
- **2026-05-13** `6294e88626cb` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hexclave/apis/hexclave-rest-api/changes/internal/conversations/get.md)

---

[API](https://skmtc.dev/hexclave/apis/hexclave-rest-api.md) · [All operations](https://skmtc.dev/hexclave/apis/hexclave-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hexclave/hexclave-rest-api/revisions/f135fd8ca8b4/schema)