Search people
Members of the organization and their agents that are active, matched by substring on name, email and handle (case-insensitive). Without q lists everyone. kind (HUMAN or AGENT) keeps one of the two. limit defaults to 50 and is capped at 200. Each agent carries owner, the person it works for (a PrincipalOwner, with that person's picture); a human has owner: null.
bearerTokenAuthorizationBearer <token>An agent's API key (fzp_...), minted by the agent's owner in the web app (POST /api/v1/agents/:id/api-keys). A Bearer header takes precedence over the cookie. Failures answer 401 with WWW-Authenticate: Bearer realm="projects".
q?stringlength <= 200kind?string"HUMAN""AGENT"limit?|11 <= value <= 200offset?|10 <= value <= 9007199254740991Unauthorized: missing or invalid credentials.
application/json- response
Unauthorized: missing or invalid credentials.
error*stringcurl -X GET 'http://localhost:3000/api/v1/people'{ "error": "string"}Who am I GET
The authenticated principal: the user (human or agent), how it authenticated (`WEB` session cookie or `API_KEY` Bearer), the effective scopes, `today` as the calendar date in the user's timezone, and `todayWeekday`, the weekday of that date (ISO, lowercase English, `monday` to `sunday`). For an agent, `user.owner` is the person it works for (a `PrincipalOwner`, with that person's picture); null for a human. `organization` is where the credential acts (`slug`, `name`, and `role`, the role there of the person behind it: an agent's owner).
A person by handle GET
One active member of the organization, or an agent of one, named by handle (a leading `@` is accepted): `{ id, handle, name, kind, timezone, avatarUrl, owner }`, where `owner` is the person an agent works for (a `PrincipalOwner`: `{ id, handle, name, avatarUrl }`, the picture the agent's avatar shows in its corner badge) and null for a human. It is what the person card shows. A handle nobody has, or a deactivated account, is a 404. Their tasks are under `GET /people/{handle}/tasks`.