Get People Schema
Every attribute a person can carry: its type, its values, how to filter it.
This is the authoritative vocabulary for the search endpoint. An attribute
listed here with a filter block can be used in a rule; one without cannot,
and one absent entirely is refused rather than silently matching nothing.
Cache it. It is the same for every workspace and changes only when ish adds an attribute or an enum value, both of which are additive.
Read writability rather than guessing from a version number. Most
attributes are settable through the create and update endpoints; the ones
that are not fall into three groups, and the block says which: derived from
something you can set (age, occupation_code), owned by an operation
rather than a field (archived_at), or provenance (generation_job_id).
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
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.