> ## Documentation Index
> Fetch the complete documentation index at: https://docs.darlinganalytics.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a conversation

> Returns a **stable, public-oriented JSON view** of a conversation (messages, chips, and
merged “thinking” steps). This is not the internal app document model.

Tabular data in chips is detected as column-oriented frames and encoded according to
`tableFormat`: **CSV strings by default**, or **arrays of row objects** when
`tableFormat=json-records`.

Use `updatedAt` (or re-fetch the whole conversation) when polling for new replies until
streaming is available.




## OpenAPI

````yaml get /conversations/{conversationId}
openapi: 3.1.1
info:
  version: 1.0.0
  title: Darling API
servers:
  - url: https://api.darlinganalytics.ai/v1
security: []
paths:
  /conversations/{conversationId}:
    get:
      summary: Get a conversation
      description: >
        Returns a **stable, public-oriented JSON view** of a conversation
        (messages, chips, and

        merged “thinking” steps). This is not the internal app document model.


        Tabular data in chips is detected as column-oriented frames and encoded
        according to

        `tableFormat`: **CSV strings by default**, or **arrays of row objects**
        when

        `tableFormat=json-records`.


        Use `updatedAt` (or re-fetch the whole conversation) when polling for
        new replies until

        streaming is available.
      parameters:
        - name: conversationId
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: tableFormat
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/PublicApiTableFormat'
            default: csv
          description: |
            Use `tableFormat` or `table_format`. Defaults to `csv`.
      responses:
        '200':
          description: Conversation snapshot
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiConversation'
        '400':
          description: Invalid query (e.g. unknown `tableFormat`)
        '401':
          description: Missing or invalid bearer token
        '404':
          description: Conversation not found or not accessible for this workspace
      security:
        - auth-header: []
components:
  schemas:
    PublicApiTableFormat:
      type: string
      enum:
        - csv
        - json-records
      description: >
        How tabular (column-oriented) chip payloads are encoded in the response.

        `csv` (default) uses RFC 4180–style CSV strings. `json-records` uses
        arrays of row objects.
    PublicApiConversation:
      type: object
      required:
        - id
        - title
        - workspaceId
        - workspaceName
        - tableFormat
        - createdAt
        - updatedAt
        - messages
      properties:
        id:
          type: string
          format: uuid
        title:
          type: string
        workspaceId:
          type: integer
        workspaceName:
          type: string
        tableFormat:
          $ref: '#/components/schemas/PublicApiTableFormat'
        createdAt:
          type: integer
          format: int64
          description: Milliseconds since Unix epoch
        updatedAt:
          type: integer
          format: int64
          description: Milliseconds since Unix epoch
        messages:
          type: array
          items:
            $ref: '#/components/schemas/PublicApiMessage'
    PublicApiMessage:
      type: object
      required:
        - id
        - conversationId
        - role
        - text
        - timestamp
        - chips
      properties:
        id:
          type: string
        conversationId:
          type: string
          format: uuid
        role:
          $ref: '#/components/schemas/PublicApiMessageRole'
        text:
          type: string
        timestamp:
          type: integer
          format: int64
          description: Milliseconds since Unix epoch
        summaries:
          type: object
          properties:
            short:
              type: string
            long:
              type: string
        rating:
          $ref: '#/components/schemas/PublicApiThumbsRating'
        dataSource:
          type: object
          properties:
            propertyId:
              type: string
            propertyName:
              type: string
            location:
              type: string
              description: kebab-case (e.g. `semantic-layer`, `windward`)
            databaseType:
              type: string
              description: kebab-case (e.g. `bigquery`)
        chips:
          type: array
          items:
            $ref: '#/components/schemas/PublicApiChip'
    PublicApiMessageRole:
      type: string
      enum:
        - user
        - assistant
    PublicApiThumbsRating:
      type: string
      enum:
        - thumbs-up
        - thumbs-down
    PublicApiChip:
      type: object
      required:
        - id
        - type
        - contentBlocks
      properties:
        id:
          type: string
        type:
          $ref: '#/components/schemas/PublicApiChipType'
        title:
          type: string
        contentBlocks:
          type: array
          items: {}
          description: >
            Parsed JSON from chip content. For `table` and `processed-table`
            chips, each element is

            column-oriented table JSON encoded as CSV (`tableFormat=csv`) or row
            objects

            (`tableFormat=json-records`); compare views use an array of such
            frames. Other chip types:

            pass-through JSON.
        chartData: {}
        thinkingSteps:
          type: array
          items:
            $ref: '#/components/schemas/PublicApiThinkingStep'
          description: Present when `type` is `thinking` (merged checkpoint chips)
    PublicApiChipType:
      type: string
      description: kebab-case chip kind (checkpoint chips are merged into `thinking`)
      enum:
        - unknown
        - table
        - sql-generation-progress
        - error
        - done
        - markdown
        - sql-generation-not-possible
        - cancel
        - processed-table
        - code-interpreter-generation-progress
        - code-interpreter-generation-not-possible
        - thinking
    PublicApiThinkingStep:
      type: object
      properties:
        checkpointId:
          type: string
        title:
          type: string
        stepType:
          type: string
          description: kebab-case checkpoint kind (e.g. `sql-generation`)
        status:
          type: string
          description: kebab-case status (e.g. `completed`)
        startedAt:
          type: integer
          format: int64
          description: Milliseconds since Unix epoch
        endedAt:
          type: integer
          format: int64
          description: Milliseconds since Unix epoch
        durationMs:
          type: integer
          description: Duration when start and end are present
        detail:
          $ref: '#/components/schemas/PublicApiThinkingStepDetail'
    PublicApiThinkingStepDetail:
      type: object
      properties:
        summaryText:
          type: string
        sql:
          type: string
        code:
          type: string
        facts:
          type: string
        itemTexts:
          type: array
          items:
            type: string
  securitySchemes:
    auth-header:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.