GET/api/v1/workspaces/{workspace_id}/members/search

Find members to mention

Up to 20 members of a workspace whose name or email contains q, for mentioning in a page: their id, name and picture, never their email. Any member can search.

API token required120 per minute per IP

Guide: Mentions and notifications

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

qstring
Part of a name or email. Leave it empty for everyone. Default "".

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.

bash

curl 'https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/members/search?q=sam' \
  -H "Authorization: Bearer $MARKDROP_TOKEN"

javascript

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

python

import os

import requests

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

Try it

API token

Kept in this tab only, and sent only to the API. Create a token

workspace_idrequired

q

Your request

curl 'https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/members/search?q=sam' \
  -H "Authorization: Bearer $MARKDROP_TOKEN"

Sends to api.markdrop.in from your browser. ⌘ ↵ sends too.

Did this page help?