---
title: "Get Agent chat"
method: GET
path: "/v1/agent-chats/{chatId}"
tags: ["Agent"]
---

# Get Agent chat

`GET /v1/agent-chats/{chatId}`

## Request

- Base URL: `https://api.inth.com`
- URL: `https://api.inth.com/v1/agent-chats/{chatId}`
- Auth: HTTP bearer

A chat with its messages. `status` is `running` while the agent is answering the latest message and `idle` once the reply is in. A reply with `failed` set ended without an answer, and so did a turn whose last message is still from the caller once `status` is `idle`. Requires agents.read and a user token.

## Path parameters

- `chatId` string, required

## Response `200`

Requested chat.

- object
  - `success` true, required
  - `data` AgentChat, required
    - `id` string, required
    - `organizationId` string, required
    - `title` string, required
    - `status` 'idle' | 'running', required
    - `messages` object[], required
      - `activities` object[]
        - `detail` string
        - `href` string
        - `id` string, required
        - `kind` 'research' | 'search' | 'source' | 'other', required
        - `status` 'running' | 'completed' | 'failed', required
        - `title` string, required
      - `author` object
        - `id` string, required
        - `name` string, required
      - `attachments` object[]
        - `id` string, required
        - `fileName` string, required
        - `mediaType` 'application/json' | 'application/pdf' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'image/gif' | 'image/jpeg' | 'image/png' | 'image/webp' | 'text/csv' | 'text/markdown' | 'text/plain', required
        - `sizeBytes` integer, required
      - `clientMessageId` string
      - `id` string, required
      - `research` object
        - `passages` object[]
          - `id` string, required
          - `receiptId` string, required
          - `text` string, required
          - `truncated` boolean, required
        - `anchoring` 'message' | 'paragraph', required
        - `anchors` object[], required
          - `claimId` string, required
          - `paragraphIndex` integer, required
        - `answerConfidence` 'degraded' | 'partial' | 'evidence-linked' | 'verified', required
        - `answerSha256` string, required
        - `claims` object[], required
          - `claimId` string, required
          - `issueId` string
          - `jurisdiction` string
          - `proposition` string
          - `qualification` string, nullable
          - `receiptIds` string[]
          - `status` 'contradicted' | 'qualified' | 'supported' | 'unsupported', required
        - `coverage` object, required
          - `qualified` integer, required
          - `supported` integer, required
          - `unresolvedCells` integer, required
        - `freezeReason` string
        - `mode` 'app-composed' | 'forced-failure' | 'model-prose' | 'model-prose-degraded-anchoring' | 'oversized-evidence', required
        - `plannerQualifications` string[]
        - `receipts` object[], required
          - `authority` string
          - `date` string, nullable
          - `dateKind` 'accessed' | 'effective' | 'published'
          - `docType` string
          - `id` string, required
          - `title` string, required
          - `url` string
        - `requiredNotices` string[]
        - `synthesisRequirementIds` string[]
        - `truncated` boolean
        - `unresolvedGaps` object[]
          - `description` string
          - `issueId` string, required
          - `jurisdiction` string, required
          - `status` string
        - `version` 1, required
      - `role` 'assistant' | 'user', required
      - `text` string, required
      - `failed` boolean, required
    - `dashboardUrl` string, required
    - `updatedAt` string, required
    - `visibility` 'personal' | 'organization', required
    - `viewerIsOwner` boolean, required
    - `owner` object, nullable, required
      - `id` string, required
      - `name` string, 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.
- `429`: The rate limit was exceeded. API key limits are set by plan tier (Starter 600/min, Pro 1500/min, Enterprise 3000/min). Check the Retry-After header before retrying.
- `500`: An unexpected internal error occurred.

## Changes

- **2026-10-31** `a3f4100e14c9`: 2 breaking, 8 info
  - the `data/dashboardUrl` response's property format changed from `uri` to no format for status `200`
  - the `data/updatedAt` response's property format changed from `date-time` to no format for status `200`
  - added the optional property `data/messages/items/activities` to the response with the `200` status
  - added the optional property `data/messages/items/attachments` to the response with the `200` status
  - …6 more
- **2026-10-23** `e3427b73824e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/inth/apis/inth-api/changes/v1/agent-chats/:chatId/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)