---
title: "Send a message"
method: POST
path: "/chat/threads/{threadId}/messages"
tags: ["Chat"]
---

# Send a message

`POST /chat/threads/{threadId}/messages`

## Request

- Base URL: `https://whatareyoudo.ing/api/v1`
- URL: `https://whatareyoudo.ing/api/v1/chat/threads/{threadId}/messages`
- Auth: HTTP bearer

Either a body or an image is required; a message with neither is rejected.

## Path parameters

- `threadId` string, uuid, required

## Request body

- SendChatMessageRequest
  - `body` string, nullable
  - `mediaAssetId` string, uuid, nullable
  - `replyToId` string, uuid, nullable

## Response `201`

Sent

- object
  - `data` ChatWrittenMessage, required
    - `id` string, uuid, required
    - `senderId` string, uuid, required
    - `body` string, nullable, required
    - `mediaAssetId` string, uuid, nullable, required
    - `replyToId` string, uuid, nullable, required
    - `unsent` boolean, required
    - `editedAt` string, nullable, required
    - `createdAt` string, required
  - `meta` object, required
    - `requestId` string, required

## Other responses

- `404`: No such thread, or the caller is not a member
- `422`: Neither a body nor an image

---

[API](https://skmtc.dev/whatareyoudo/apis/whatcha-api.md) · [All operations](https://skmtc.dev/whatareyoudo/apis/whatcha-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whatareyoudo/apis/whatcha-api/revisions/48dd8a54abea?raw)