People
The Drop Directory roster — every signed-in @himarley.com user with their group + Space affiliations.
The People tab of the Drop Directory is the live roster of every signed-in @himarley.com user, with their group and Space affiliations. V1 is small-scale (~150 rows), so the API returns the whole list in a single call — no pagination, no cursors.
Two endpoints, two jobs
GET /api/people— the directory feed: full list, full affiliations, sortable A–Z, suitable for rendering the People tab or driving a roster export.GET /api/users/search— the picker typeahead: at most 10 results, prefix-ranked, name + email + id only — optimized for the header palette and the "Add people" access panel.
Visibility & hidden groups
Anyone signed in can read the People feed — the directory is intentionally open inside Hi Marley. The one guard: ADMIN_ONLY group affiliations are stripped from groupSlugs for non–People Admin callers. The People feed is not a side-channel for enumerating hidden groups (or even inferring their existence).
isPeopleAdmin on each row is derived from membership in the @drop-people-admins system role group (not a column).
CLI commands
| Command | What it does |
|---|---|
drop people | List the whole directory (substring [query] arg optional) |
drop people <query> | Substring filter against name, title, email |
drop people list [query] | Same as the bare command — explicit subcommand |
drop people get <email-or-id> | Show one person: groups, Spaces, role badges |
drop people --show-deactivated | Include deactivated users (forward-compat; no-op today) |
drop people --limit <n> | Cap rows (default 50 unfiltered, all when filtered) |
drop people --json | Pipe-friendly output; works on list and get |
MCP tool
drop_people takes an optional query (substring across name/title/email) and an optional limit (max rows). Each result row carries email, name, title, group slugs (prefixed @ in the rendered text), Space slugs, and the two admin flags. Registered in both the standalone Drop MCP server and the remote /api/mcp endpoint — same shape, same description, both alongside drop_spaces.
Operations
List people
Return the whole directory or a substring-filtered slice.
# Whole directory
drop people
# Substring filter
drop people jonathan
# Pipe-friendly
drop people --json | jq '.users[].email'Get one person
Look up one user by email or id. Returns groups, Spaces, and role badges.
drop people get colleague@himarley.comTypeahead search (picker)
Lighter endpoint for the access-panel "Add people" picker and header palette. Returns at most 10 results, prefix-ranked, name + email + id only — no group affiliations. Don't use for full directory queries.
curl 'https://drop.himarley.ai/api/users/search?q=jon' \
-H "Authorization: Bearer $DROP_TOKEN"