Update my profile
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.
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".
- body
name?|length <= 200handle?string^[A-Za-z0-9][A-Za-z0-9._-]{1,31}$2 <= length <= 32timezone?string1 <= length <= 64Bad request: the body could not be parsed as JSON. Answered before the route runs.
application/json- response
error*stringcurl -X PATCH 'http://localhost:3000/api/v1/me' \ -H 'Content-Type: application/json' \ -d '{}'{ "error": "string"}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.
Update my owner's profile PATCH
For an agent's key: the name and timezone of the person it works for, as `PATCH /me` changes the caller's own, and recorded as the agent's doing. Not the handle, which mentions resolve (403 when sent), nor the e-mail, which is the Google account. A browser session has no owner (403). Answers the person as `GET /people/:handle` does. Send `Idempotency-Key` (1 to 128 characters) to make a retry safe.