---
title: "Read support conversation history"
method: GET
path: "/v1/support/conversations/{conversationId}"
tags: ["Support"]
---

# Read support conversation history

`GET /v1/support/conversations/{conversationId}`

## Request

- Base URL: `https://api.inth.com`
- URL: `https://api.inth.com/v1/support/conversations/{conversationId}`
- Auth: HTTP bearer

Reads the known ID directly, independently of list or sync windows. Returns up to 100 messages in chronological order with structured authors and complete attachment metadata. Continue with nextCursor until null. Save checkpoint and pass it as cursor to poll for new messages. Internal operator notes are excluded. Attachment downloadUrl paths accept the same bearer token. Requires support.read and a user token. Organization API keys cannot call this operation. No operator or staff access is granted.

## Path parameters

- `conversationId` string, required

## Query parameters

- `organizationId` string
- `cursor` string

## Response `200`

Success

- object
  - `success` unknown, required
  - `data` PublicSupportConversationThread, required
    - `organizationId` string, required
    - `conversation` SupportConversationEncoded, required
      - `id` string, required
      - `subject` string, required
      - `status` 'open' | 'closed', required
      - `visibility` 'personal' | 'organization', required
      - `creator` SupportAuthorEncoded, required
        - `id` string, required
        - `name` string, required
      - `closedAt` string, nullable, required: An ISO 8601 UTC date-time string.
      - `createdAt` string, required: An ISO 8601 UTC date-time string.
      - `updatedAt` string, required: An ISO 8601 UTC date-time string.
    - `messages` object[], required
      - `id` string, required
      - `conversationId` string, required
      - `role` 'customer' | 'agent' | 'system' | 'internal_note', required
      - `source` 'web' | 'slack' | 'backoffice' | 'email', required
      - `authorKind` 'human' | 'system', required
      - `author` SupportAuthorEncoded, required
        - `id` string, required
        - `name` string, required
      - `clientMessageId` string, uuid, nullable, required
      - `text` string, required
      - `attachments` object[], required
        - `id` string, required
        - `messageId` string, nullable, required
        - `fileName` string, required
        - `mediaType` string, required
        - `sizeBytes` integer, required
        - `kind` 'image' | 'screen_recording' | 'file', required
        - `status` 'uploading' | 'ready' | 'failed', required
        - `downloadUrl` string, required
        - `failureReason` string, nullable
        - `createdAt` string, required: An ISO 8601 UTC date-time string.
        - `uploadedAt` string, nullable, required: An ISO 8601 UTC date-time string.
      - `sentAt` string, required: An ISO 8601 UTC date-time string.
    - `nextCursor` string, nullable, required
    - `checkpoint` string, nullable, required
    - `hasMore` boolean, required

## Other responses

- `400`: The request payload or parameters are invalid.
- `401`: Authentication is missing, invalid, or expired.
- `403`: The credential is valid but may not perform the operation. `INSUFFICIENT_SCOPE`: the credential was never granted the capability the operation needs. `details.requiredScope` names it, and the `WWW-Authenticate` header carries `Bearer error="insufficient_scope"`. An OAuth client fixes this by requesting the scope; an organization API key cannot gain it. `FORBIDDEN`: the capability is present but the membership behind the credential lacks the role, or the resource belongs to another organization.
- `404`: The requested resource was not found.

## Changes

- **2026-10-31** `a3f4100e14c9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/inth/apis/inth-api/changes/v1/support/conversations/:conversationId/get.md)

---

[API](https://skmtc.dev/inth/apis/inth-api.md) - [All operations](https://skmtc.dev/inth/apis/inth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/inth/apis/inth-api/revisions/8741280c3463?raw)