---
title: "Upload a locale logo"
method: POST
path: "/settings/locales/{id}/logo"
tags: ["Admin Settings: Locales"]
---

# Upload a locale logo

`POST /settings/locales/{id}/logo`

## Request

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

Send multipart/form-data with `logo` (an image: jpeg, jpg, png or webp). Stored as locales/{code}.{extension}, replacing the current logo. Returns the locale detail.

## Path parameters

- `id` integer, required

## Request body `multipart/form-data`

- object
  - `logo` string, binary, required

## Response `200`

Logo stored. Returns the locale detail.

## Other responses

- `400`: Invalid input
- `403`: Missing settings.locales.edit permission.
- `404`: Locale not found.
- `422`: Missing or invalid logo.

## Changes

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

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