---
title: "Get a conversation"
method: GET
path: "/api/v1/w/{wId}/assistant/conversations/{cId}"
tags: ["Conversations"]
---

# Get a conversation

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

Get a conversation in the workspace identified by {wId}. Supports optional pagination of message content via limit and lastValue query parameters.

## Path parameters

- `wId` string, required
- `cId` string, required

## Query parameters

- `limit` integer
- `lastValue` string

## Response `200`

Conversation retrieved successfully.

- Conversation
  - `conversation` object
    - `id` integer
    - `created` integer
    - `sId` string — Unique string identifier for the conversation
    - `owner` Workspace
      - `id` integer
      - `sId` string — Unique string identifier for the workspace
      - `name` string — Name of the workspace
      - `role` string — User's role in the workspace
      - `segmentation` string, nullable — Segmentation information for the workspace
      - `flags` string[]
      - `ssoEnforced` boolean
      - `regionalModelsOnly` boolean, required — When true, only models whose regionalAvailability includes the workspace's region are usable.
      - `whiteListedProviders` string[]
      - `defaultEmbeddingProvider` string, nullable — Default provider for embeddings in the workspace
    - `title` string — Title of the conversation
    - `visibility` string — Visibility setting of the conversation
    - `content` array[]
      - object[]
        - `id` integer
        - `sId` string — Unique string identifier for the message
        - `type` string — Type of the message
        - `visibility` string — Visibility setting of the message
        - `version` integer
        - `created` integer
        - `user` User
          - `sId` string — Unique string identifier for the user
          - `id` integer
          - `createdAt` integer
          - `username` string — User's chosen username
          - `email` string — User's email address
          - `firstName` string — User's first name
          - `lastName` string — User's last name
          - `fullName` string — User's full name
          - `provider` string — Authentication provider used by the user
          - `image` string — URL of the user's profile image
        - `mentions` Mention[]
          - `configurationId` string — ID of the mentioned agent configuration
        - `content` string — Content of the message
        - `context` Context
          - `username` string, required — Username in the current context
          - `timezone` string, required — User's timezone
          - `fullName` string — User's full name in the current context
          - `email` string — User's email in the current context
          - `profilePictureUrl` string — URL of the user's profile picture
          - `selectedSpaceIds` string[]
          - `agenticMessageData` object
            - `type` 'run_agent' | 'agent_handover' — Type of the agentic message
            - `originMessageId` string — ID of the origin message
        - `agentMessageId` integer
        - `parentMessageId` string — ID of the parent message
        - `status` string — Status of the message
        - `actions` object[]
          - `generatedFiles` object[] — Files generated by this action. Path-backed files have `fileId: null` and can be downloaded through the conversation files endpoint using `filePath`.
            - `fileId` string, nullable — Dust file id for DB-backed files, or null for path-backed files.
            - `filePath` string — Canonical scoped path for path-backed files, as surfaced by agent file system tools.
            - `title` string
            - `contentType` string
            - `snippet` string, nullable
            - `hidden` boolean
            - `isInProjectContext` boolean
        - `chainOfThought` string, nullable — Chain of thought for the message
        - `rawContents` object[]
          - `step` integer
          - `content` string — Content for each step
        - `error` string, nullable — Error message, if any
        - `configuration` AgentConfiguration
          - `id` integer
          - `sId` string — Unique string identifier for the agent configuration
          - `version` integer
          - `versionCreatedAt` string, nullable — Timestamp of when the version was created
          - `versionAuthorId` string, nullable — ID of the user who created this version
          - `name` string — Name of the agent configuration
          - `description` string — Description of the agent configuration
          - `instructions` string, nullable — Instructions for the agent
          - `pictureUrl` string — URL of the agent's picture
          - `status` string — Current status of the agent configuration
          - `scope` string — Scope of the agent configuration
          - `userFavorite` boolean — Status of the user favorite for this configuration
          - `model` object
            - `providerId` string — ID of the model provider
            - `modelId` string — ID of the specific model
            - `temperature` number
          - `actions` unknown[]
            - unknown
          - `maxStepsPerRun` integer
          - `templateId` string, nullable — ID of the template used for this configuration

## Other responses

- `400` — Bad Request. Missing or invalid parameters.
- `401` — Unauthorized. Invalid or missing authentication token.
- `404` — Conversation not found.
- `500` — Internal Server Error.

---

[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)