GET/api/v1/workspaces/{workspace_id}/documents

List workspace documents

The documents filed in a workspace.

API token required120 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.

Query parameters

pageinteger
Page number, from 1. At least 1. Default 1.
limitinteger
How many to return. From 1 to 100. Default 20.
per_pageinteger
From 1 to 50.
qstring
kindstring
One of markdown, document, artifact. One of markdown, document, artifact.
folder_idstring
The folder's id, from List folders.
unfiledboolean
Default false.

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

documentsarray of object
30 fields inside
- idstring | null
- slugstring
- urlstring
- titlestring | null
  Shown on the page and in link previews.
- content_previewstring
- 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.
- expires_atstring (date-time) | null
  ISO 8601, for example 2026-11-30T12:00:00Z.
- viewsinteger
  Default 0.
- export_pdf_countinteger
  Default 0.
- copy_url_countinteger
  Default 0.
- is_password_protectedboolean
  Default false.
- google_doc_urlstring | null
- google_doc_staleboolean
  Default false.
- vscode_syncedboolean
  Default false.
- encryptedboolean
  Set by clients that encrypt in the browser: content and title are already ciphertext. The server never sees the key. Default false.
- kindstring
  Default "markdown".
- mimestring | null
- rendererstring | null
- type_labelstring | null
- size_bytesinteger | null
- original_filenamestring | null
- workspace_idstring | null
- folder_idstring | null
- folder_patharray of string
- access_levelstring
  Who can open it: link (anyone with the link), private (only you and the people you share it with) or workspace (members of its workspace). Default "link".
- shared_with_countinteger
  Default 0.
- shared_by_namestring | null
- shared_by_emailstring | null
- is_mineboolean
  Default true.
totalinteger
pageinteger
pagesinteger
per_pageinteger
Default 20.
count_allinteger
Default 0.
count_markdowninteger
Default 0.
count_artifactinteger
Default 0.

const res = await fetch("https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/documents", { headers: { Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`, }, }); const data = await res.json();

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