POST/api/v1/workspaces/{workspace_id}/folders

Create a folder

Creates a folder at the top level, or inside another folder with parent_id.

API token required60 per minute per IP

Guide: Folders

Code samples and Try it

Path parameters

workspace_idstringRequired
The workspace's id, from the address of its settings page (markdrop.in/settings/workspaces/<workspace-id>) or from List workspaces.

Request body

application/json, required

namestringRequired
1–80 characters.
parent_idstring
Create it inside this folder. Leave it out for the top level.

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: 8 fields (FolderResponse)

idstring
workspace_idstring
namestring
parent_idstring | null
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.
slugstring
Default "".
patharray of string

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

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