Sign in
Library

Create a currency

post/library/currencies

Request

  • Base URL: https://next-api.saturation.io/v1
  • URL: https://next-api.saturation.io/v1/library/currencies
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Unique request key, 16 to 255 characters. Retrying the same request returns the first response. Missing or invalid keys return 400 validation; reuse with a different body returns 409 idempotency_conflict.

Request body

codestring
namestring nullable
symbolstring nullable
rateToUSDnumber nullable

USD value of one unit of this currency. For example, use 1.17 for EUR when one EUR equals 1.17 USD.

Response

The created currency.

idstring required

A stable resource ID, such as prj_…, txn_…, or doc_….

codestring required

ISO 4217 currency code.

namestring nullable
symbolstring nullable
rateToUSDnumber nullable

USD value of one unit of this currency.

Example response

{
  "id": "txn_8f2a1c9e"
}

Changes

No recorded changes to this operation across all 4 revisions of this API.