Skip to main content
POST
Create a board
Write access: a member/administrator with a write-enabled credential, or an authorized signed-in user. Create a board. Tasks use Mill’s fixed statuses. Requires workspace-wide write access. Prefixes use 2–10 uppercase letters/digits with a leading letter; omission derives an available prefix from the name. Every board uses the same six fixed statuses. MCP clients can use create_board for this operation. Request conventions · API keys · MCP connections

Authorizations

Authorization
string
header
required

Personal or team Mill REST API key

Headers

Origin
string<uri>

The exact configured Mill UI origin. Required for browser mutations carrying session cookies.

Idempotency-Key
string

Reuse the same key and exact request bytes for retries of one logical mutation; different content conflicts.

Required string length: 8 - 128
Pattern: ^[A-Za-z0-9._:-]+$

Body

application/json
name
string
required
Required string length: 1 - 100
prefix
string
Pattern: ^[A-Z][A-Z0-9]{1,9}$
description
string
default:""
Maximum string length: 10000

Response

Successful response. Examples are illustrative; field values vary by record.

Illustrative response shape. Fields can be absent in alternate successful flows; see the operation description and example.

board
object