---
title: "Set the user's avatar"
method: POST
path: "/user/settings/avatar"
tags: ["user"]
---

# Set the user's avatar

`POST /user/settings/avatar`

Changes the user avatar. Valid types are gravatar (uses the user email), upload, initials, marble, ldap (synced from LDAP server), openid (synced from OpenID provider), default.

## Request body

- V1UserAvatarProvider
  - `avatar_provider` string — The avatar provider. Valid types are `gravatar` (uses the user email), `upload`, `initials`, `marble` (generates a random avatar for each user), `ldap` (synced from LDAP server), `openid` (synced from OpenID provider), `default`.

## Response `200`

OK

- ModelsMessage
  - `message` string — A standard message.

## Other responses

- `400` — Something's invalid.
- `500` — Internal server error.

---

[API](https://skmtc.net/go-vikunja/apis/vikunja-api.md) · [All operations](https://skmtc.net/go-vikunja/apis/vikunja-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/go-vikunja/vikunja-api/revisions/feb3f68bbdf1/schema)