Skip to main content
GET
Get People Schema

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

Response

Successful Response

The person attribute vocabulary this workspace can read and filter on.

This is the authoritative list: a rule naming an attribute that is not here is refused rather than quietly matching nothing. Fetch it once and cache it. It changes when ish adds an attribute or an enum value, not per request, and it is the same for every workspace.

attributes
PersonAttribute · object[]
required