Skip to main content
POST
Create an area

Authorizations

Authorization
string
header
required

A pc_… token generated from Settings > API & MCP.

Body

application/json
name
string
required
Required string length: 1 - 200
hue
integer | null

Anodized metal hue angle from 0 to 360 degrees.

Required range: 0 <= x <= 360
icon
string | null
Required string length: 1 - 60
notes
string

Markdown: bold, italic, headings, lists, quotes, rules, links, inline code, tables and checkboxes. Do not use code blocks (```) or images: the app's editor does not support them and truncates the display from that point on.

Maximum string length: 10000
workspaceId
string<uuid>

Where to file it: the personal workspace by default, or a team workspace the caller sits in.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Created.

area
object
required