Skip to content

Members

Inside your library, people are identified by library-local integer ids. Those ids appear in every payload (comment authors, lock holders, reviewers) and are what you pass as reviewer_ids, assignee_id and requested_by. These endpoints need only read scope. They never expose email addresses or roles of other people.

Workspace membership itself (inviting and removing people, roles) is managed in the account dashboard; see Workspace and members.

Method and path Purpose
GET /members/me Your own library id and role
GET /members Active members, for typeahead and pickers
GET /members/{member_id} One member’s profile and contribution counts
{
"member": { "id": 7, "name": "<user>", "display_name": "Sam Rigger" },
"role": "admin",
"is_admin": true
}

Use member.id to recognize your own comments, locks and review assignments. (GET /auth/me returns your account id instead; see Authentication.)

Parameter Type Description
q string Case-insensitive prefix match on name or display name (1 to 100 characters).
limit integer 1 to 200, default 200. No cursor.
{ "members": [{ "id": 12, "name": "<user>", "display_name": "Lee Lead" }] }

Lists active people who have used the library, ordered by name. name can be an opaque identifier; show display_name to people.

{
"member": { "id": 12, "name": "<user>", "display_name": "Lee Lead" },
"joined_at": "2026-07-10T09:00:00Z",
"last_active_at": null,
"counts": {
"assets_published": 120,
"versions_published": 311,
"reviews_responded": 45,
"reviews_waiting": 2,
"comments": 88,
"annotations": 17
}
}

joined_at is when the person first used the library. last_active_at can be null. Unknown id: 404 USER_NOT_FOUND.