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

# Remove an admin user avatar

`DELETE /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/delete.ts> (a function with typed inputs; its response is checked against the schema)

Clears the avatar and deletes the stored file. Returns the user detail.

## Path parameters

- `id` integer, required

## Response `200`

Avatar removed. Returns the user detail.

## Other responses

- `403`: Missing settings.users.edit permission.
- `404`: Admin user not found.

## Changes

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

[Operation history](https://skmtc.dev/bagisto/apis/bagisto-admin-api/changes/settings/users/:id/image/delete.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)