A person by handle
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.
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".
handle*string1 <= length <= 33Unauthorized: missing or invalid credentials.
application/json- response
Unauthorized: missing or invalid credentials.
error*stringcurl -X GET 'http://localhost:3000/api/v1/people/string'{ "error": "string"}Search people GET
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`.
A profile photo GET
The image behind an `avatarUrl` that is a photo: 256 px, or 64 with `?size=64`, WebP. Any signed-in principal may see it, as anyone can see a person's name. A redirect to a short-lived link on the bucket, or the bytes when photos live in the database. A photo that was replaced or removed is a 404.