---
title: "Update conversation"
method: PATCH
path: "/internal/conversations/{conversationId}"
tags: ["Others"]
---

# Update conversation

`PATCH /internal/conversations/{conversationId}`

Append a message or update conversation attributes on a managed project conversation

## Path parameters

- `conversationId` string, required

## Response `200`

Successful response

- object
  - `conversation` object, required
    - `conversationId` string, required
    - `userId` string
    - `teamId` string
    - `userDisplayName` string
    - `userPrimaryEmail` string
    - `userProfileImageUrl` string
    - `subject` string, required
    - `status` 'open' | 'pending' | 'closed', required
    - `priority` 'low' | 'normal' | 'high' | 'urgent', required
    - `source` 'manual' | 'chat' | 'email' | 'api', required
    - `lastMessageType` 'message' | 'internal-note' | 'status-change', required
    - `preview` string
    - `lastActivityAt` string, required
    - `metadata` object, required
      - `assignedToUserId` string
      - `assignedToDisplayName` string
      - `tags` string[], required
      - `firstResponseDueAt` string
      - `firstResponseAt` string
      - `nextResponseDueAt` string
      - `lastCustomerReplyAt` string
      - `lastAgentReplyAt` string
    - `createdAt` string
    - `updatedAt` string
    - `lastMessageAt` string
    - `lastInboundAt` string
    - `lastOutboundAt` string
    - `closedAt` string
    - `recordMetadata` object
  - `messages` object[], required
    - `id` string, required
    - `conversationId` string, required
    - `userId` string
    - `teamId` string
    - `subject` string, required
    - `status` 'open' | 'pending' | 'closed', required
    - `priority` 'low' | 'normal' | 'high' | 'urgent', required
    - `source` 'manual' | 'chat' | 'email' | 'api', required
    - `messageType` 'message' | 'internal-note' | 'status-change', required
    - `body` string
    - `attachments` object[], required
    - `metadata` object
    - `createdAt` string, required
    - `sender` object, required
      - `type` 'user' | 'agent' | 'system', required
      - `id` string
      - `displayName` string
      - `primaryEmail` string
  - `entryPoints` object[], required
    - `id` string, required
    - `channelType` string, required
    - `adapterKey` string, required
    - `externalChannelId` string
    - `isEntryPoint` boolean, required
    - `metadata` object
    - `createdAt` string, required
    - `updatedAt` string, required

## Changes

- **2026-05-15** `f135fd8ca8b4` — 31 warning
  - added the new `agent` enum value to the `messages/items/sender/type` response property for the response status `200`
  - added the new `api` enum value to the `conversation/source` response property for the response status `200`
  - added the new `api` enum value to the `messages/items/source` response property for the response status `200`
  - added the new `chat` enum value to the `conversation/source` response property for the response status `200`
  - …27 more
- **2026-05-13** `6294e88626cb` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hexclave/apis/hexclave-rest-api/changes/internal/conversations/:conversationId/patch.md)

---

[API](https://skmtc.dev/hexclave/apis/hexclave-rest-api.md) · [All operations](https://skmtc.dev/hexclave/apis/hexclave-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hexclave/hexclave-rest-api/revisions/f135fd8ca8b4/schema)