docs
Principals

A person by handle

GET
/v1/people/{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.

Authorization

bearerToken
headerAuthorizationBearer <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".

Path Parameters

handle*string
Length1 <= length <= 33

Response Body

Unauthorized: missing or invalid credentials.

application/json
  1. response

Unauthorized: missing or invalid credentials.

error*string
Example Request
curl -X GET 'http://localhost:3000/api/v1/people/string'
Example Response
{  "error": "string"}