Get People Counts
How many people this credential can reach, split by owner.
Cheaper than paging the list to find out, and the number you want before building a filter: it tells you whether a rule that matches 3 people is a precise audience or a nearly-empty workspace. Exact counts, not estimates.
Counts the same pool the list pages, archive state included: a count that disagreed with the list it introduces would be worse than no count.
Authorizations
Workspace API key as a bearer token: Authorization: Bearer ish_sk_live_.... Keys are workspace-scoped machine principals minted in Settings > Developers (shown once at mint). Scopes: sessions:run (create a session, submit turns, close), sessions:read (read the session and its decision trace), environments:read and environments:write (manage the workspace's registered environments), tasks:read and tasks:write (manage the workspace's registered tasks), people:read and people:write (the people the workspace can run a session for), and usage:read (the workspace's own consumption, spend limits and rate-limit budgets). A key is minted with sessions:run, sessions:read, and tasks:read by default; every other scope must be requested, people:read and usage:read included. An ish user access token also works on the same header for personal scripts.
Path Parameters
Query Parameters
false (the default) counts live people, matching what the list serves; true counts the archive.
Response
Successful Response
How large the pool is, split by owner.
The feasibility seed: before building a filter you want to know whether the
workspace has 4 people or 4000, and how much of that is the shared library.
total is exactly self + platform (the two sets are disjoint), and
all three are exact counts, not estimates.