Get a paginated list of conversations for a project, sorted by newest first. Only the project owner can access this endpoint.

• Conversations are sorted by createdAt DESC (newest first).
• Supports optional filtering by status (ACTIVE or CLOSED).
• The messageCount field is computed (not stored) — it reflects the total number of messages in the conversation.
• The updatedAt field reflects the timestamp of the last message added to the conversation.
• Only the owner of the project (tenant check) can list its conversations.

sequenceDiagram
    actor User

    User->>+FE: opens Conversations list for a project

    FE->>+BE: GET /api/v1/projects/{projectId}/conversations <br> Authorization: Bearer {accessToken}

    BE->>BE: validate access token
    alt token missing or invalid
        BE-->>FE: 401 Unauthorized <br> ErrorResponse
    end

    BE->>DB: load project by projectId
    alt project not found
        BE-->>FE: 404 Not Found <br> ErrorResponse
    end

    BE->>BE: check project belongs to user's tenant
    alt project does not belong to tenant
        BE-->>FE: 403 Forbidden <br> ErrorResponse
    end

    BE->>DB: query conversations for project (with optional status filter, paginated)

    BE->>-FE: 200 OK <br> ConversationListResponse

    FE->>-User: display conversations list

GET /api/v1/projects/{projectId}/conversations

Query parameters:

• status (optional) — filter by status: ACTIVE or CLOSED
• page (optional, default 0) — zero-based page number
• size (optional, default 20) — page size

200 OK ConversationListResponse:

{
  "data": {
    "content": [
      {
        "id": 7,
        "title": "Add a contact form to the homepage",
        "status": "ACTIVE",
        "messageCount": 5,
        "createdAt": "2026-04-29T10:30:00Z",
        "updatedAt": "2026-04-29T11:00:00Z"
      },
      {
        "id": 3,
        "title": "Change the color scheme to dark mode",
        "status": "CLOSED",
        "messageCount": 12,
        "createdAt": "2026-04-28T09:00:00Z",
        "updatedAt": "2026-04-28T10:15:00Z"
      }
    ],
    "page": 0,
    "size": 20,
    "totalElements": 2,
    "totalPages": 1
  }
}

401 Unauthorized (missing or invalid access token) ErrorResponse:

{
  "status": 401,
  "code": "AUTHENTICATION_FAILED",
  "message": "Access token is missing or invalid"
}

403 Forbidden (project does not belong to user’s tenant) ErrorResponse:

{
  "status": 403,
  "code": "FORBIDDEN",
  "message": "You do not have access to this project"
}

404 Not Found (project not found) ErrorResponse:

{
  "status": 404,
  "code": "NOT_FOUND_PROJECT",
  "message": "Project not found"
}

Frontend

Validations

Backend

Validations

Test Cases