DELETE/api/v1/workspaces/{workspace_id}

Delete a workspace

Deletes a workspace, its folders and its domains. Documents filed in it are not deleted: they go back to their owners. Send the workspace's name to confirm.

API token required10 per hour 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.

Request body

application/json, required

confirm_namestringRequired
The workspace's name, typed back, to confirm. 1–80 characters.

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.

200 response: 3 fields (WorkspaceDeleteResponse)

documents_releasedinteger
domains_removedinteger
members_removedinteger

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

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