---
title: "Retrieve conversation"
method: GET
path: "/agents/{agentId}/conversations/{conversation_id}"
tags: ["Conversations"]
---

# Retrieve conversation

`GET /agents/{agentId}/conversations/{conversation_id}`

## Path parameters

- `agentId` string, required
- `conversation_id` string, required

## Response `200`

The conversation

- InconvoConversation
  - `id` string, required
  - `userIdentifier` string, nullable — Unique identifier for the end-user (may be null for legacy conversations)
  - `context` object, nullable, required — User context values (null when user context is disabled)
  - `messages` Message[], required
    - `id` string — Present on Inconvo responses only
    - `type` 'text' | 'chart' | 'table' | 'error', required
    - `message` string, required
    - `chart` Chart — Charts use vega V5 spec https://vega.github.io/schema/vega/v5.json
    - `table` Table
      - `head` string[], required
      - `body` array[], required
        - string[]

---

[API](https://skmtc.net/inconvoai/apis/inconvo-conversations-api.md) · [All operations](https://skmtc.net/inconvoai/apis/inconvo-conversations-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/inconvoai/inconvo-conversations-api/revisions/2524aa5bde1f/schema)