---
title: "Record feedback on a chat"
method: PATCH
path: "/api/v1/chats/{id}"
tags: ["chat"]
---

# Record feedback on a chat

`PATCH /api/v1/chats/{id}`

## Path parameters

- `id` string, uuid, required

## Request body

- ChatUpdateRequestDTO
  - `feedbackRating` boolean, nullable — User thumbs up/down
  - `feedbackText` string, nullable — User free-text feedback

## Response `200`

- ChatUpdateResponseDTO
  - `assistantActions` object[], nullable, required — Tool actions performed by the assistant
    - `content` unknown
    - `externalMessageReferenceId` string, required — Provider message id the action is attached to
    - `externalToolCallReferenceId` string, required — Provider tool-call id that produced the action
    - `hyperLink` string — Optional link surfaced to the user for this action
    - `toolName` string, required — Name of the tool the assistant invoked
  - `callId` string, nullable, required — Provider call id, for voice chats
  - `createdAt` string, date-time, required — Creation timestamp
  - `externalSessionId` string, nullable, required — The originating provider's conversation id, when the chat has one
  - `feedbackRating` boolean, nullable, required — User thumbs up/down
  - `feedbackText` string, nullable, required — User free-text feedback
  - `id` string, uuid, required — Chat id
  - `lastUpdatedAt` string, date-time, required — Last update timestamp
  - `organizationId` string, uuid, required — Organization id
  - `source` 'ai-sdk' | 'elevenlabs' | 'whatsapp', required — System that produced the chat
  - `status` 'pending' | 'active' | 'completed' | 'connected', required — Chat lifecycle status
  - `title` string, nullable, required — Chat title
  - `type` 'web_call' | 'text_chat' | 'phone_call' | 'whatsapp', required — Chat channel type
  - `userId` string, uuid, required — Owning user id

---

[API](https://skmtc.net/wejam/apis/jam.md) · [All operations](https://skmtc.net/wejam/apis/jam/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wejam/jam/revisions/bd5a5f406bca/schema)