---
title: "List conversations"
method: GET
path: "/api/w/{wId}/assistant/conversations"
tags: ["Private Conversations"]
---

# List conversations

`GET /api/w/{wId}/assistant/conversations`

Retrieve a paginated list of conversations for the authenticated user in the workspace.

## Path parameters

- `wId` string, required

## Response `200`

Successfully retrieved conversations

- object
  - `conversations` PrivateConversation[]
    - `id` integer, required
    - `created` integer, required — Unix timestamp of creation
    - `updated` integer, required — Unix timestamp of last update
    - `unread` boolean
    - `lastReadMs` integer, nullable
    - `actionRequired` boolean — Whether the conversation requires user action
    - `hasError` boolean
    - `sId` string, required
    - `title` string, nullable
    - `spaceId` string, nullable — ID of the space the conversation belongs to (for project conversations)
    - `triggerId` string, nullable
    - `depth` integer, required — Conversation depth (for agent handover chains)
    - `metadata` object
    - `requestedSpaceIds` string[]
    - `forkingData` PrivateConversationForkingData
      - `forkedFrom` PrivateConversationForkedFrom
        - `parentConversationId` string, required
        - `parentConversationTitle` string, nullable, required
        - `sourceMessageId` string, required
        - `branchedAt` integer, required
        - `user` PrivateConversationForkUser, required
          - `sId` string
          - `id` integer
          - `createdAt` integer
          - `provider` 'auth0' | 'github' | 'google' | 'okta' | 'samlp' | 'waad', nullable
          - `username` string
          - `email` string
          - `firstName` string
          - `lastName` string, nullable
          - `fullName` string
          - `image` string, nullable
          - `lastLoginAt` integer, nullable
        - `fileCopyStatus` 'pending' | 'done', required
      - `forkedChildren` PrivateConversationForkedChild[]
        - `childConversationId` string
        - `childConversationTitle` string, nullable
        - `sourceMessageId` string
        - `branchedAt` integer
        - `user` PrivateConversationForkUser
          - `sId` string
          - `id` integer
          - `createdAt` integer
          - `provider` 'auth0' | 'github' | 'google' | 'okta' | 'samlp' | 'waad', nullable
          - `username` string
          - `email` string
          - `firstName` string
          - `lastName` string, nullable
          - `fullName` string
          - `image` string, nullable
          - `lastLoginAt` integer, nullable
  - `hasMore` boolean
  - `lastValue` string, nullable

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/dust-tt/apis/dust-api-documentation.md) · [All operations](https://skmtc.net/dust-tt/apis/dust-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dust-tt/dust-api-documentation/versions/5834d690c29d/schema)