---
title: "Upload an admin user avatar"
method: POST
path: "/settings/users/{id}/image"
tags: ["Admin Settings: Users"]
---

# Upload an admin user avatar

`POST /settings/users/{id}/image`

## Request

- Base URL: `http://localhost:8000/api/admin`
- URL: `http://localhost:8000/api/admin/settings/users/{id}/image`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bagisto/apis/bagisto-admin-api/docs/settings/users/:id/image/post.ts> (a function with typed inputs; its response is checked against the schema)

Send multipart/form-data with `image` (jpeg, jpg, png, gif, max 10000 KB). Replaces the current avatar. Returns the user detail.

## Path parameters

- `id` integer, required

## Request body `multipart/form-data`

- object
  - `image` string, binary, required

## Response `200`

Avatar stored. Returns the user detail.

## Other responses

- `400`: Invalid input
- `403`: Missing settings.users.edit permission.
- `404`: Admin user not found.
- `422`: Missing or invalid image.

## Changes

- **2026-10-28** `3198f11be70f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bagisto/apis/bagisto-admin-api/changes/settings/users/:id/image/post.md)

---

[API](https://skmtc.dev/bagisto/apis/bagisto-admin-api.md) - [All operations](https://skmtc.dev/bagisto/apis/bagisto-admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bagisto/apis/bagisto-admin-api/revisions/3198f11be70f?raw)