---
title: "Deactivate a Currency Exchange Rate"
method: PATCH
path: "/channel/v1/exchangeRates/{currencyExchangeRateUuid}"
tags: ["CurrencyExchangeRate"]
---

# Deactivate a Currency Exchange Rate

`PATCH /channel/v1/exchangeRates/{currencyExchangeRateUuid}`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/channel/v1/exchangeRates/{currencyExchangeRateUuid}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/channel/v1/exchangeRates/:currencyExchangeRateUuid/patch.ts> (a function with typed inputs; its response is checked against the schema)

Deactivate a Currency Exchange Rate. To stop supporting currency exchange on your marketplace, deactivate a rate. This will prevent the exchange rate from being used to convert usage.

## Path parameters

- `currencyExchangeRateUuid` string, required

## Request body

- CurrencyExchangeRateActive
  - `active` boolean: Currency Exchange Rates can be only deactivated. Allowed value: false.

## Response `200`

OK

- CurrencyExchangeRateResponse
  - `baseCurrency` 'USD' | 'CAD' | 'EUR' | 'JPY' | 'GBP' | 'KRW' | 'CHF' | 'SEK' | 'SGD' | 'MYR' | 'AUD' | 'MXN' | 'INR' | 'BRL' | 'DKK' | 'NZD' | 'NOK' | 'ZAR' | 'PHP' | 'CNY' | 'SAR' | 'GTQ' | 'IDR' | 'ARS' | 'COP' | 'PEN': Supported currencies for the system
  - `counterCurrency` 'USD' | 'CAD' | 'EUR' | 'JPY' | 'GBP' | 'KRW' | 'CHF' | 'SEK' | 'SGD' | 'MYR' | 'AUD' | 'MXN' | 'INR' | 'BRL' | 'DKK' | 'NZD' | 'NOK' | 'ZAR' | 'PHP' | 'CNY' | 'SAR' | 'GTQ' | 'IDR' | 'ARS' | 'COP' | 'PEN': Supported currencies for the system
  - `rate` number: A currency pair is the quotation and pricing structure of the currencies traded in a forex market. A Currency Pair is represented as XXX/YYY where XXX is the Base currency and YYY is the Counter currency. In AppDirect the Base currency is an external currency and the Counter currency is a supported currency in your marketplace. When an exchange rate is provided with a Currency Pair, it represents how much of the Counter currency is required to purchase 1 unit of the Base currency. EUR/USD=1.18; EUR is the Base currency and USD is the counter currency. 1 EUR is equal to 1.18 USD. In order to buy 1 EUR, the buyer must pay 1.18 USD.
  - `validFrom` number: Date from which the rate is valid
  - `active` boolean: Whether or not the exchange rate is active and can be used in a conversion event
  - `authenticationType` string: The type of authentication used to create or change an exchange rate instance
  - `oauthKey` string: The oauth key used to create or change an exchange rate instance
  - `userId` number: The user id of the user who created or changed an exchange rate instance
  - `currencyExchangeRateUuid` string: Unique identifier for the object

## Other responses

- `404`: Not Found

## Changes

- **2026-11-06** `1fc240f06971`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/channel/v1/exchangeRates/:currencyExchangeRateUuid/patch.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)