Create a design space

POST /spaces

Updated 16 Sep 20262 min read

POST/spacesTry it

Basehttps://api.mockflow.com/v1Scopesboards:write

Request

curl https://api.mockflow.com/v1/spaces \
  -X POST \
  -H "Authorization: Bearer $MOCKFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Q4 Launch Planning"
}'

const response = await fetch("https://api.mockflow.com/v1/spaces", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MOCKFLOW_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "name": "Q4 Launch Planning"
})
});

const data = await response.json();

import os, requests

response = requests.post(
    "https://api.mockflow.com/v1/spaces",
    headers={"Authorization": f"Bearer {os.environ['MOCKFLOW_API_KEY']}"},
    json={
  "name": "Q4 Launch Planning"
},
)

response.raise_for_status()
data = response.json()

Response

{
  "id": "string",
  "name": "Q4 Launch Planning",
  "builtIn": false,
  "role": "owner",
  "boardCount": 0,
  "memberCount": 0
}

{
  "error": {
    "code": "plan_limit",
    "message": "AI credits exhausted. 0 of 2000 remaining this month.",
    "upgradeUrl": "https://mockflow.com/pricing"
  },
  "requestId": "req_01ja"
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests.",
    "docsUrl": "https://mockflow.com/developers/concepts/errors#rate_limited"
  },
  "requestId": "req_45d49816999bac40"
}

Basic accounts have one space; the cap answers 402.

Authorization

Authorizationstringheaderrequired

Bearer <key>. The key needs boards:write scope. Create and manage keys in the developer console; what each scope unlocks is on the scopes page.

Body

application/json

namestringrequired

Response

201 · application/json

idstring

A space id, or the reserved default and trash.

namestring

builtInboolean

roleenum<string>

The product's roles. Owner is the workspace that holds the board or space and cannot be granted or transferred. Admin can rename and share, editor can edit, reviewer can view, export and add comment items. There is no viewer role and no pending state. One of owner, admin, editor or reviewer.

boardCountinteger

memberCountinteger

coverUrlstring | null

publicUrlstring | null

positioninteger

Dashboard order, lowest first.

createdBystring | null

createdAtstring | null

updatedAtstring | null

deletedAtstring | null

Errors

402plan_limit

The workspace plan does not allow this, or AI credits are exhausted.

429rate_limited

Too many requests.

Was this page helpful?