Generate items from a prompt

Mida turns a prompt into one or more items on the board. With one outputTypes entry the matching generator runs directly; with none, Mida's planner decides what to build, as it does in the editor. skill applies a saved skill's instructions and output type. withImages lets Mida generate pictures inside the result. Plus and Max only; charged in AI credits. dryRun returns an estimate without spending anything.

post/boards/{boardId}/ai/generate

Request

Base URL
https://api.mockflow.com/v1
Auth
HTTP bearer

Headers

Idempotency-Keystring

A unique key per logical request. Replays within 24 hours return the original response.

Request body

callbackUrlstring uri

Optional. When the job this request starts finishes or fails, a short body is POSTed here once: { eventId, status, boardId, boardUrl, imageUrl }, where status is succeeded or failed and imageUrl is a picture of what the job drew, or null. Signed with the workspace's callback secret (GET /webhooks/callback-secret). https to a public host. The full job is on GET /jobs/{jobId}.

promptstring required

outputTypesItemType[]

skillstring

A skill id or slug from GET /skills.

withImagesboolean

modelstring

A text model id from the editor's model picker. Omit for Mida's default.

dryRunboolean

Example request

{
  "callbackUrl": "https://hooks.zapier.com/hooks/standard/123/abc"
}

Response

The dry run estimate.

dryRunboolean

planstring

canGenerateboolean

Changes

No recorded changes to this operation across all 1 revision of this API.