A profile photo
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.
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".
id*string^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$size?string"64""256"Unauthorized: missing or invalid credentials.
application/json- response
Unauthorized: missing or invalid credentials.
error*stringcurl -X GET 'http://localhost:3000/api/v1/photos/string'{ "error": "string"}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`.
Update my profile PATCH
Partial: omitted fields are untouched, `name: null` (or a blank name) clears the name. `handle` is lowercased and must be unique regardless of case (409 otherwise); `timezone` is an IANA name and moves `today` and `todayWeekday` with it. An agent cannot change its own `handle` here (403): its owner sets it once, when the agent is created. A patch that changes nothing answers 200 and records no activity. Answers the same body as `GET /me`. Send `Idempotency-Key` (1 to 128 characters) to make a retry safe.