Skip to main content
GET
Get People Counts

Authorizations

Authorization
string
header
required

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

workspace_id
string<uuid>
required

Query Parameters

archived
boolean
default:false

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.

platform
integer
required

People published in the shared ish library.

self
integer
required

People this workspace owns.

total
integer
required

People reachable with this credential.