POST/api/v1/workspaces/{workspace_id}/items/add

File documents

Files documents you own into the workspace. Their access stays the same unless you send access.

API token required60 per minute per IPMCP: add_to_workspace

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

slugsarray of stringRequired
Addresses of documents you own. 1–200 items.
folder_idstring
File them in this folder. Leave it out for the top level.
access"link" | "private" | "workspace"
Also change who can open them. Left out, their access doesn't change.

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 POST https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/items/add \ -H "Authorization: Bearer $MARKDROP_TOKEN" \ -H "Content-Type: application/json" \ -d '{"slugs":["k3x9q2m"],"folder_id":"FOLDER_ID"}'

const res = await fetch("https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/items/add", { method: "POST", headers: { Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ "slugs": [ "k3x9q2m" ], "folder_id": "FOLDER_ID" }), }); const data = await res.json();

import os import requests r = requests.post( "https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/items/add", headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"}, json={"slugs": ["k3x9q2m"], "folder_id": "FOLDER_ID"}, ) r.raise_for_status() print(r.json())