---
title: "Have Mida draft a skill"
method: POST
path: "/skills/draft"
tags: ["Skills"]
---

# Have Mida draft a skill

`POST /skills/draft`

## Request

- Base URL: `https://api.mockflow.com/v1`
- URL: `https://api.mockflow.com/v1/skills/draft`
- Auth: HTTP bearer

Returns a draft (name, description, system prompt, placeholder, tags) for a description and an output type. Nothing is saved; send it to POST /skills when you are happy with it. Charged in AI credits.

## Request body

- object
  - `description` string, required
  - `outputType` string, required

## Response `200`

The draft.

- SkillCreate
  - `name` string, required
  - `description` string
  - `outputType` string, required
  - `category` 'general' | 'brainstorm' | 'diagrams' | 'planning' | 'media'
  - `systemPrompt` string, required
  - `placeholder` string
  - `tags` string[]
  - `model` string

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