Optimizely Currencies API

The Currencies API from Optimizely — 7 operation(s) for currencies.

Operations 11

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/v1/admin/Currencies List currencies · Returns the EntitySet Currencies #
Ask an LLM
“Which currencies are configured in my Optimizely commerce admin?”
“Can I find which currency is set as the default?”
Tell an agent
List all configured currencies.
List currencies matching {filter}.
POST /api/v1/admin/Currencies Add a currency · Post a new entity to EntitySet Currencies #
Ask an LLM
“How do I add a new currency like EUR with its symbol?”
“Can I make a newly added currency the default one?”
Tell an agent
Add currency {currencyCode} described as {description} with symbol {currencySymbol}.
Create currency {currencyCode} ({description}, {currencySymbol}) with isDefault {isDefault}.
GET /api/v1/admin/Currencies({id}) Get a currency · Returns the entity with the key from Currencies #
Ask an LLM
“What symbol and code does a given currency record use?”
“Can I look up one currency by its id?”
Tell an agent
Get currency {id}.
Show the code and symbol of currency record {id}.
PUT /api/v1/admin/Currencies({id}) Replace a currency record · Replace entity in EntitySet Currencies #
Ask an LLM
“How do I overwrite a whole currency definition?”
“Can I replace a currency's code, description and symbol together?”
Tell an agent
Replace currency {id} with code {currencyCode}, description {description} and symbol {currencySymbol}.
Fully overwrite currency record {id}.
DELETE /api/v1/admin/Currencies({id}) Delete a currency · Delete entity in EntitySet Currencies #
Ask an LLM
“How do I remove a currency we no longer sell in?”
“Can I make a currency deletion conditional on its ETag?”
Tell an agent destructive · confirm first
Delete currency {id}.
Delete currency {id} only if the ETag matches {etag}.
PATCH /api/v1/admin/Currencies({id}) Update a currency · Update entity in EntitySet Currencies #
Ask an LLM
“How do I change just the symbol of a currency?”
“Can I switch which currency is the default with a partial update?”
Tell an agent
Change currency {id}'s symbol to {currencySymbol}.
Set isDefault to {isDefault} on currency {id}.
GET /api/v1/admin/Currencies/Default.Default() Get a blank default currency · Call operation Default #
Ask an LLM
“What does a blank currency object look like before I create one?”
“Is there a starter template for a new currency?”
Tell an agent
Get the default template for a new currency.
Show the blank currency object.
DELETE /api/v1/admin/currencies/delete Delete several currencies · Currencies delete route #
Ask an LLM
“Can I delete multiple currencies in one call?”
“How do I bulk-remove currencies by id?”
Tell an agent destructive · confirm first
Delete currencies {ids}.
Bulk-remove the currencies with ids {ids}.
GET /api/v1/admin/currencies({key})/currencyrates({currencyrateKey}) Get an exchange rate for a currency · Currencies get currency rate by key and currencyratekey #
Ask an LLM
“How do I read one exchange rate record attached to a currency?”
“What conversion rate is stored for a currency?”
Tell an agent
Get currency rate {currencyrateKey} for currency {key}.
Show exchange rate record {currencyrateKey} of currency {key}.
GET /api/v1/admin/currencies({key})/customproperties({custompropertyKey}) Get a currency custom property · Currencies get custom property by key and custompropertykey #
Ask an LLM
“Can I read a custom property stored on a currency?”
“How do I fetch extra custom data attached to a currency?”
Tell an agent
Get custom property {custompropertyKey} of currency {key}.
Show currency {key}'s custom property {custompropertyKey}.
GET /api/v1/admin/currencies({key})/websitecurrencies({websitecurrencyKey}) Get a website's use of a currency · Currencies get website currency by key and websitecurrencykey #
Ask an LLM
“Is a currency enabled on a particular website?”
“How do I fetch the website-currency link for a currency?”
Tell an agent
Get website currency {websitecurrencyKey} for currency {key}.
Show the website assignment {websitecurrencyKey} of currency {key}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/optimizely:optimizely-currencies-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

optimizely-currencies-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  version: admin-v1
  title: Admin API V1 Currencies API
servers:
- url: https://dogfood.commerce.insitesandbox.com
security: []
tags:
- name: Currencies
paths:
  /api/v1/admin/Currencies:
    get:
      tags:
      - Currencies
      summary: Returns the EntitySet Currencies
      operationId: Currencies_Get
      parameters:
      - name: $expand
        in: query
        description: Expands related entities inline.
        required: false
        schema:
          type: string
      - name: $filter
        in: query
        description: Filters the results, based on a Boolean condition.
        required: false
        schema:
          type: string
      - name: $select
        in: query
        description: Selects which properties to include in the response.
        required: false
        schema:
          type: string
      - name: $apply
        in: query
        description: Aggregates the results according to one or more transformations.
        required: false
        schema:
          type: string
      - name: $orderby
        in: query
        description: Sorts the results.
        required: false
        schema:
          type: string
      - name: $top
        in: query
        description: Returns only the first n results.
        required: false
        schema:
          type: integer
          format: int32
      - name: $skip
        in: query
        description: Skips the first n results.
        required: false
        schema:
          type: integer
          format: int32
      - name: $count
        in: query
        description: Includes a count of the matching results in the response.
        required: false
        schema:
          type: boolean
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
    post:
      tags:
      - Currencies
      summary: Post a new entity to EntitySet Currencies
      operationId: Currencies_Post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Insite.Data.Entities.Currency'
        description: The entity to post
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/Currencies({id}):
    get:
      tags:
      - Currencies
      summary: Returns the entity with the key from Currencies
      operationId: Currencies_GetById
      parameters:
      - name: id
        in: path
        description: 'key: id'
        required: true
        schema:
          type: string
          format: uuid
      - name: $expand
        in: query
        description: Expands related entities inline.
        required: false
        schema:
          type: string
      - name: $select
        in: query
        description: Selects which properties to include in the response.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
    put:
      tags:
      - Currencies
      summary: Replace entity in EntitySet Currencies
      operationId: Currencies_PutById
      parameters:
      - name: id
        in: path
        description: 'key: id'
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Insite.Data.Entities.Currency'
        description: The entity to put
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
    delete:
      tags:
      - Currencies
      summary: Delete entity in EntitySet Currencies
      operationId: Currencies_DeleteById
      parameters:
      - name: id
        in: path
        description: 'key: id'
        required: true
        schema:
          type: string
          format: uuid
      - name: If-Match
        in: header
        description: If-Match header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
    patch:
      tags:
      - Currencies
      summary: Update entity in EntitySet Currencies
      operationId: Currencies_PatchById
      parameters:
      - name: id
        in: path
        description: 'key: id'
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Insite.Data.Entities.Currency'
        description: The entity to patch
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/Currencies/Default.Default():
    get:
      tags:
      - Currencies
      summary: Call operation Default
      operationId: Currencies_Default
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/currencies/delete:
    delete:
      tags:
      - Currencies
      operationId: Currencies_DeleteRoute
      parameters:
      - name: ids
        in: query
        required: true
        explode: true
        schema:
          type: array
          items:
            type: string
            format: uuid
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
      summary: Currencies delete route
      x-summary-source: derived
  /api/v1/admin/currencies({key})/currencyrates({currencyrateKey}):
    get:
      tags:
      - Currencies
      operationId: Currencies_GetCurrencyRateByKeyAndCurrencyratekey
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: currencyrateKey
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: $expand
        in: query
        description: Expands related entities inline.
        required: false
        schema:
          type: string
      - name: $select
        in: query
        description: Selects which properties to include in the response.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
      summary: Currencies get currency rate by key and currencyratekey
      x-summary-source: derived
  /api/v1/admin/currencies({key})/customproperties({custompropertyKey}):
    get:
      tags:
      - Currencies
      operationId: Currencies_GetCustomPropertyByKeyAndCustompropertykey
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: custompropertyKey
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: $expand
        in: query
        description: Expands related entities inline.
        required: false
        schema:
          type: string
      - name: $select
        in: query
        description: Selects which properties to include in the response.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
      summary: Currencies get custom property by key and custompropertykey
      x-summary-source: derived
  /api/v1/admin/currencies({key})/websitecurrencies({websitecurrencyKey}):
    get:
      tags:
      - Currencies
      operationId: Currencies_GetWebsiteCurrencyByKeyAndWebsitecurrencykey
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: websitecurrencyKey
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: $expand
        in: query
        description: Expands related entities inline.
        required: false
        schema:
          type: string
      - name: $select
        in: query
        description: Selects which properties to include in the response.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
      summary: Currencies get website currency by key and websitecurrencykey
      x-summary-source: derived
components:
  schemas:
    Insite.Data.Entities.Currency:
      required:
      - currencyCode
      - description
      - currencySymbol
      type: object
      properties:
        id:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        currencyCode:
          maxLength: 50
          minLength: 0
          type: string
        description:
          maxLength: 255
          minLength: 0
          type: string
        currencySymbol:
          maxLength: 50
          minLength: 0
          type: string
        isDefault:
          type: boolean
        createdOn:
          format: date-time
          type: string
        createdBy:
          type: string
        modifiedOn:
          format: date-time
          type: string
        modifiedBy:
          type: string
  securitySchemes:
    access_token:
      type: apiKey
      description: Token used to access storefront API.
      name: access_token
      in: query