---
title: "Post to the team chat"
method: POST
path: "/boards/{boardId}/chat"
tags: ["Collaboration"]
---

# Post to the team chat

`POST /boards/{boardId}/chat`

## Request

- Base URL: `https://api.mockflow.com/v1`
- URL: `https://api.mockflow.com/v1/boards/{boardId}/chat`
- Auth: HTTP bearer

Posts as the token's owner. Everyone with the board open sees it at once. Mention `@Mida`,
or send `askMida: true`, and Mida answers in the chat; the answer arrives as a later message,
not in this response.

## Request body

- object
  - `message` string, required
  - `askMida` boolean

## Response `201`

Posted.

- object
  - `id` string
  - `author` object
    - `email` string
    - `name` string
  - `fromMida` boolean
  - `text` string
  - `html` string
  - `pinnedAt` object, nullable
    - `x` number
    - `y` number
  - `at` string, date-time
  - `midaQueued` boolean

## Other responses

- `429`: Too many requests.
- `4XX`: An error. See the envelope and the code list on the Errors page.

---

[API](https://skmtc.dev/mockflow/apis/mockflow-boards-api.md) - [All operations](https://skmtc.dev/mockflow/apis/mockflow-boards-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mockflow/apis/mockflow-boards-api/revisions/1a890390518c?raw)