---
title: "Ask Mida about the board"
method: POST
path: "/boards/{boardId}/ai/ask"
tags: ["AI"]
---

# Ask Mida about the board

`POST /boards/{boardId}/ai/ask`

## Request

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

Answers from the board's own content, the same text the outline shows, and cites the items it used. Charged in AI credits.

## Request body

- object
  - `question` string, required

## Response `200`

The answer.

- object
  - `answer` string: Markdown.
  - `sources` object[]
    - `itemId` string
    - `title` string
  - `creditsUsed` integer

## Other responses

- `402`: The workspace plan does not allow this, or AI credits are exhausted.
- `429`: Too many requests.

---

[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)