---
title: "Update a currency"
method: PUT
path: "/settings/currencies/{id}"
tags: ["Admin Settings: Currencies"]
---

# Update a currency

`PUT /settings/currencies/{id}`

## Request

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

Validates name (required). Code is immutable in the monolith UI; if sent here it will be ignored by the repository payload filter.

## Path parameters

- `id` integer, required

## Request body

- object
  - `name` string, required
  - `symbol` string
  - `decimal` integer
  - `group_separator` string
  - `decimal_separator` string
  - `currency_position` string

## Response `200`

Currency updated.

- AdminSettingsCurrency: Admin Settings → Currencies endpoints (Block B Wave 1). REST: GET /api/admin/settings/currencies — datagrid-parity listing GET /api/admin/settings/currencies/{id} — detail POST /api/admin/settings/currencies — create PUT /api/admin/settings/currencies/{id} — update DELETE /api/admin/settings/currencies/{id} — delete (guards: last currency, channel base) GraphQL: adminSettingsCurrencies — cursor listing adminSettingsCurrency(id:) — detail createAdminSettingsCurrency — create updateAdminSettingsCurrency — update deleteAdminSettingsCurrency — delete Mirrors Webkul\Admin\Http\Controllers\Settings\CurrencyController 1:1.
  - `id` integer, nullable
  - `code` string, nullable
  - `name` string, nullable
  - `symbol` string, nullable
  - `decimal` integer, nullable
  - `groupSeparator` string, nullable
  - `decimalSeparator` string, nullable
  - `currencyPosition` string, nullable
  - `createdAt` string, nullable
  - `updatedAt` string, nullable
  - `message` string, nullable

## Other responses

- `400`: Invalid input
- `404`: Currency not found.
- `422`: Validation failure.

---

[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)