GET/api/v1/workspaces

List workspaces

The workspaces you belong to, with your role in each and their live domains.

API token required60 per minute per IPMCP: list_workspaces CLI: markdrop workspaces

Responses

200OK.
401No token, or the token is revoked or mistyped.
429Too many requests from your IP address. Wait the seconds in Retry-After.

200 response: 1 field (WorkspaceListResponse)

workspacesarray of object
15 fields inside
- idstring
- namestring
- owner_idstring
- 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.
- brandingobject
  Every field optional — an unset workspace looks exactly like Markdrop.
- settingsobject
- role"owner" | "admin" | "member" | "viewer"
- primary_hoststring | null
- domainsarray of object
- default_accessstring
  Default "workspace".
- privacystring
  Default "custom".
- member_countinteger
  Default 0.
- pending_invite_countinteger
  Default 0.
- domain_countinteger
  Default 0.

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