> For the complete documentation index, see [llms.txt](https://docs.ibexa.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ibexa.ai/developers/rest-api/users/upload-avatar-me.md).

# Upload Avatar Me

Upload or replace the current user's avatar (square, >=256px, <=2MB).

```json
{"openapi":"3.1.0","info":{"title":"Ibexa Agentic Marketing Platform","version":"0.1.0"},"security":[{"OAuth2PasswordBearer":[]}],"components":{"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"/api/v1/login/access-token"}}}},"schemas":{"Body_users-upload_avatar_me":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_users-upload_avatar_me"},"UserMeResponseSchema":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"User ID"},"email":{"type":"string","title":"Email","description":"User email"},"status":{"$ref":"#/components/schemas/UserStatus","description":"User account status"},"is_superuser":{"type":"boolean","title":"Is Superuser","description":"Whether the user is a superuser"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name","description":"User's full name"},"organisation_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Organisation Id","description":"Organisation ID"},"job_position":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Position","description":"User's job position"},"job_activities":{"items":{"type":"string"},"type":"array","title":"Job Activities","description":"User's job activities"},"newsletter_consent":{"type":"boolean","title":"Newsletter Consent","description":"Newsletter consent","default":false},"preferred_locale":{"anyOf":[{"$ref":"#/components/schemas/PreferredLocale"},{"type":"null"}],"description":"User's preferred locale for the product UI"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url","description":"Cacheable URL to the user's avatar, or null if none is set"}},"type":"object","required":["id","email","status","is_superuser"],"title":"UserMeResponseSchema","description":"Response schema for current user information."},"UserStatus":{"type":"string","enum":["ACTIVE","INACTIVE","BLOCKED"],"title":"UserStatus","description":"Account status of a user.\n\nState machine transitions:\n- INACTIVE → ACTIVE (activate)\n- ACTIVE → INACTIVE (deactivate)\n- ACTIVE → BLOCKED (block)\n- BLOCKED → ACTIVE (unblock)"},"PreferredLocale":{"type":"string","enum":["en-US","es-ES","fr-FR","de-DE"],"title":"PreferredLocale","description":"Locales the product's UI is currently translated into."}}},"paths":{"/api/v1/users/me/avatar":{"put":{"tags":["users","public"],"summary":"Upload Avatar Me","description":"Upload or replace the current user's avatar (square, >=256px, <=2MB).","operationId":"users-upload_avatar_me","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_users-upload_avatar_me"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserMeResponseSchema"}}}},"400":{"description":"Invalid request payload or parameters","content":{"application/json":{}}},"403":{"description":"User lacks permission","content":{"application/json":{}}},"413":{"description":"Avatar exceeds the maximum allowed size","content":{"application/json":{}}},"415":{"description":"Avatar media type is not supported","content":{"application/json":{}}}}}}}}
```