Update my owner's profile
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.
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 <= 200timezone?string1 <= length <= 64handle?stringlength <= 32Bad 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/owner' \ -H 'Content-Type: application/json' \ -d '{}'{ "error": "string"}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.
Upload my owner's profile photo PUT
For an agent's key: the photo of the person it works for, recorded as the agent's doing. A browser session has no owner (403). The body is the image itself, JPEG, PNG or WebP, at most 5 MB (413 past it; 422 for anything that does not decode as one of the three, whatever its `Content-Type` says). The client is expected to crop it to a square; the server makes the two renditions the app draws, 64 and 256 px in WebP, and keeps them in the attachments bucket (`avatars/<id>/`) or, with no bucket configured, in the database. Answers `{ avatarUrl }`, the new `GET /photos/:id`. The photo it replaces is deleted.