---
title: "What Mida would build, without building it"
method: POST
path: "/boards/{boardId}/ai/plan"
tags: ["AI"]
---

# What Mida would build, without building it

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

## Request

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

The planner's proposal for a prompt, the same one the editor shows for approval before it generates. Nothing is drawn and no generation credits are spent.

## Request body

- object
  - `prompt` string, required
  - `outputTypes` ItemType[]

## Response `200`

The plan.

- object
  - `multi` boolean
  - `boardTitle` string
  - `items` object[]
    - `id` string
    - `name` string
    - `description` string
    - `type` string
    - `sizeHint` string, nullable
    - `group` string, nullable

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