PATCH/api/v1/workspaces/{workspace_id}/folders/{folder_id}

Rename or move a folder

Renames a folder, changes its address, moves it (parent_id; null is the top level) or sets the access new documents in it start with. Admins and the owner. Every document below it moves to its new address.

API token required60 per minute per IP

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.
folder_idstringRequired
The folder's id, from List folders.

Request body

application/json, required

namestring
1–80 characters.
slugstring
1–40 characters.
parent_idstring
default_access"link" | "private" | "workspace"

Responses

200OK.
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.

curl -X PATCH https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/folders/FOLDER_ID \ -H "Authorization: Bearer $MARKDROP_TOKEN" \ -H "Content-Type: application/json" \ -d '{"name":"Handbook"}'

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

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