POST/api/v1/workspaces

Create a workspace

Creates a workspace with you as its owner.

API token required10 per minute per IP

Guide: Create a workspace

Code samples and Try it

Request body

application/json, required

namestringRequired
1–80 characters.

Responses

201Created.
401No token, or the token is revoked or mistyped.
422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
429Too many requests from your IP address. Wait the seconds in Retry-After.

201 response: 15 fields (WorkspaceResponse)

idstring
namestring
owner_idstring
created_atstring (date-time)
ISO 8601, for example 2026-11-30T12:00:00Z.
updated_atstring (date-time)
ISO 8601, for example 2026-11-30T12:00:00Z.
brandingobject
Every field optional — an unset workspace looks exactly like Markdrop.
6 fields inside
- site_namestring | null
  Up to 60 characters.
- favicon_urlstring | null
  Up to 500 characters.
- logo_urlstring | null
  Up to 500 characters.
- accent_colorstring | null
  Matches ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$.
- hide_markdrop_brandingboolean
  Default false.
- logo_well"light" | "dark" | "checker" | null
settingsobject
4 fields inside
- viewer_chrome"full" | "minimal" | "none"
  Default "full".
- require_auth_to_viewboolean
  Default false.
- members_can_share_foldersboolean
  Default true.
- default_access"link" | "workspace" | "private"
  Default "workspace".
role"owner" | "admin" | "member" | "viewer"
primary_hoststring | null
domainsarray of object
9 fields inside
- hoststring
- kindstring | null
- statusstring
  Default "pending".
- verifiedboolean
- primaryboolean
- liveboolean
- txt_okboolean | null
- routing_okboolean | null
- failuresinteger
  Default 0.
default_accessstring
Default "workspace".
privacystring
Default "custom".
member_countinteger
Default 0.
pending_invite_countinteger
Default 0.
domain_countinteger
Default 0.

const res = await fetch("https://api.markdrop.in/api/v1/workspaces", { method: "POST", headers: { Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ "name": "Acme" }), }); const data = await res.json();

import os import requests r = requests.post( "https://api.markdrop.in/api/v1/workspaces", headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"}, json={"name": "Acme"}, ) r.raise_for_status() print(r.json())