Upload my profile photo
My photo, shown everywhere I am drawn ahead of my Google picture (or, for an agent, of its bot glyph). An agent's key sets the agent's own photo; its owner can also set it in Settings (PUT /agents/:id/photo), and PUT /me/owner/photo is the owner's own. 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.
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".
Unauthorized: missing or invalid credentials.
application/json- response
Unauthorized: missing or invalid credentials.
error*stringcurl -X PUT 'http://localhost:3000/api/v1/me/photo'{ "error": "string"}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.
Delete a project DELETE
Soft delete: the row stays with `deletedAt` and the project answers 404 from then on. Only the owner or an admin (403), only without sub-projects that are not deleted (422), never a personal project (422). Its tasks go to the trash, unless `ifEmpty: true` is sent, in which case any task still in the project (added since the caller last read it) is a 422 instead of being trashed. Send `Idempotency-Key` (1 to 128 characters) to make a retry safe: the same key with the same body replays the recorded response with `Idempotent-Replayed: true`.