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

Preview items

What the Cards view shows of each item, for up to 12 items at a time. Each answers locked unless you can open it right now, encrypted for an end-to-end encrypted document, and pending while a picture is being made (ask again). Otherwise ok with plain-text blocks (pages, documents, HTML and Word files), a sheet's first rows, a text file's first lines, or src, a small WebP thumbnail as a data URI (images, a PDF's first page, a video's poster, a page's cover). An HTML file also has live, its signed address on the files origin. Any member.

API token required240 per minute per IPMCP: list_workspace_items

Guide: Browse a 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
1–12 items.

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/previews \ -H "Authorization: Bearer $MARKDROP_TOKEN" \ -H "Content-Type: application/json" \ -d '{"slugs":["k3x9q2m","q3-report"]}'

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

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