FIfirefly-iii
currencies

Update existing currency.

Update existing currency.

put/v1/currencies/{code}

Request

  • Base URL
    https://demo.firefly-iii.org/api
  • URL
    https://demo.firefly-iii.org/api/v1/currencies/{code}
  • Auth
    • OAuth 2
      Authorization code: https://demo.firefly-iii.org/oauth/authorize
      Token URL: https://demo.firefly-iii.org/oauth/token
    • or HTTP bearer

Path parameters

codestring string required
Example:EUR

The currency code.

Headers

X-Trace-Idstring uuid
Example:40c71bbb-c676-4f24-83cf-cc725d7d7a00

Unique identifier associated with this request.

Request body

enabledboolean

If the currency is enabled

primarytrue

If the currency must be the primary for the user. You can only submit TRUE. Submitting FALSE will not drop this currency as the primary currency, because then the system would be without one.

codestring string

The currency code

namestring string

The currency name

symbolstring string

The currency symbol

decimal_placesinteger

How many decimals to use when displaying this currency. Between 0 and 16.

Example request

{
  "enabled": true,
  "primary": true,
  "code": "AMS",
  "name": "Ankh-Morpork dollar",
  "symbol": "AM$",
  "decimal_places": 2
}

Response

Updated currency stored, result in response

Example response

{
  "data": {
    "type": "currencies",
    "id": "2",
    "attributes": {
      "created_at": "2026-02-01T00:00:00+00:00",
      "updated_at": "2026-02-01T00:00:00+00:00",
      "enabled": true,
      "code": "AMS",
      "name": "Ankh-Morpork dollar",
      "symbol": "AM$",
      "decimal_places": 2
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.