---
title: "Send a reply or note"
method: POST
path: "/conversations/{id}/messages"
tags: ["Messages"]
---

# Send a reply or note

`POST /conversations/{id}/messages`

## Request

- Base URL: `https://muro.chat/api/v1`
- URL: `https://muro.chat/api/v1/conversations/{id}/messages`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `content` string, required
  - `kind` 'agent' | 'note'
  - `attachments` unknown[]
    - unknown
  - `replyTo` object: Quote an earlier message this reply threads under.
    - `messageId` string, required
    - `preview` string, required
    - `senderName` string, required

## Response `201`

The created message (same shape as list).

- Message
  - `object` 'message'
  - `id` string
  - `conversation_id` string
  - `sender_type` 'visitor' | 'agent' | 'system' | 'note'
  - `sender_id` string, nullable
  - `content` string
  - `attachments` unknown[]
    - unknown
  - `created_at` string, date-time

## Other responses

- `400`: Invalid body.
- `404`: Conversation not found.
- `409`: Idempotency-Key reused with a different body.
- `415`: Content-Type must be application/json.

---

[API](https://skmtc.dev/muro/apis/muro-rest-api.md) · [All operations](https://skmtc.dev/muro/apis/muro-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/muro/apis/muro-rest-api/revisions/94ccdc79d61a?raw)
