---
title: "Get a chat"
method: POST
path: "/v1/actions/get_chat"
tags: ["Messages"]
---

# Get a chat

`POST /v1/actions/get_chat`

## Request

- Base URL: `https://api.heyreagent.com`
- URL: `https://api.heyreagent.com/v1/actions/get_chat`
- Auth: HTTP bearer

Read one conversation.

Docs: https://heyreagent.com/docs/actions/get_chat

## Request body

- object
  - `chatId` string, required: The conversation id (from list_chats).
  - `connectionId` string: Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one.

## Response `200`

It worked. Inside result: id, accountType, providerId, attendeeProviderId, name, type, timestamp, unreadCount, archived, mutedUntil, readOnly, disabledFeatures, subject, organizationId, mailboxId, contentType, folder, pinned, lastMessage.messageId, lastMessage.providerId, lastMessage.senderId, lastMessage.text, lastMessage.id, lastMessage.chatId, lastMessage.chatProviderId, lastMessage.timestamp, lastMessage.isSender, lastMessage.isForwarded, lastMessage.isViewOnce, lastMessage.seen, lastMessage.hidden, lastMessage.deleted, lastMessage.edited, lastMessage.isEvent, lastMessage.delivered, lastMessage.behavior, lastMessage.eventType, lastMessage.original, lastMessage.replies, lastMessage.replyBy, lastMessage.parent, lastMessage.senderAttendeeId, lastMessage.subject, lastMessage.messageType, lastMessage.attendeeType, lastMessage.attendeeDistance, lastMessage.senderUrn.

- Worked
  - `ok` true, required
  - `result` object, required: What was asked for. A field that does not apply is left out, or is null.

## Other responses

- `default`: It did not work. The message says why, in plain English.

---

[API](https://skmtc.dev/heyreagent/apis/heyreagent-api.md) · [All operations](https://skmtc.dev/heyreagent/apis/heyreagent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heyreagent/apis/heyreagent-api/revisions/917360c5f841?raw)