Set a profile picture
POST/agents/:agent_id/profile/avatar
multipart/form-data with an avatar part — PNG, JPEG, GIF or WebP, up to 5 MB.
The upload is validated by decoding the image, not by trusting its
Content-Type: a file that merely claims to be a PNG is rejected.
The returned avatar_url is an authenticated proxy path, never a public
Cloud Storage URL — a person's face should not be permanently addressable by
anybody who once saw the link.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 413
Picture updated.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
The request was malformed, or a parameter was rejected.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
No token, an expired token, or a credential that has been revoked.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
Refused. Either the credential does not hold the scope this endpoint needs (code: insufficient_scope), or the account's IP allow-list does not include the calling address (code: ip_not_allowed).
Response Headers
Correlation id for this request. Quote it when reporting a problem.
No such resource in this account.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
The request was malformed, or a parameter was rejected.
Response Headers
Correlation id for this request. Quote it when reporting a problem.