Optimizely

Optimizely Languages API

The Languages API from Optimizely — 6 operation(s) for languages.

GitHub OpenAPI

Operations 10

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/Languages List storefront languages · Returns the EntitySet Languages #
Ask an LLM
“Which languages are set up in the Optimizely Configured Commerce admin?”
“Can I find which language is marked as the default?”
Tell an agent
List all configured languages.
List languages matching {filter}, sorted by {orderby}.
POST /api/v1/admin/Languages Add a language · Post a new entity to EntitySet Languages #
Ask an LLM
“What codes and tags do I need to add a new language to the storefront?”
“Can a new language have persona-specific or device-specific content?”
Tell an agent
Add language {languageCode} described as {description}, culture {cultureCode}, tag {languageTag}, alternates {alternateLanguages}, flag image {imageFilePath}.
Create language {languageCode} and make it the default: {isDefault}.
GET /api/v1/admin/Languages({id}) Get one language by ID · Returns the entity with the key from Languages #
Ask an LLM
“How do I look up a single language's culture code by its ID?”
“Can I choose which language fields come back for one record?”
Tell an agent
Show language {id}.
Fetch language {id}, selecting {select}.
PUT /api/v1/admin/Languages({id}) Replace a language record entirely · Replace entity in EntitySet Languages #
Ask an LLM
“Can I overwrite a language with a complete new set of values?”
“What happens to language fields I leave out on a full replace?”
Tell an agent
Replace language {id} with a full record using code {languageCode} and culture {cultureCode}.
Overwrite every field of language {id}, setting the description to {description}.
DELETE /api/v1/admin/Languages({id}) Delete a single language · Delete entity in EntitySet Languages #
Ask an LLM
“How do I remove one language from the storefront by its ID?”
“Can I make a language delete conditional on an ETag?”
Tell an agent destructive · confirm first
Delete language {id}.
Delete language {id} only if its ETag matches {etag}.
PATCH /api/v1/admin/Languages({id}) Update selected fields on a language · Update entity in EntitySet Languages #
Ask an LLM
“Can I change just where the currency symbol is positioned for a language?”
“How would I switch which language is the default?”
Tell an agent
Patch language {id} so currency positioning is {currencyPositioning}.
Update language {id} to set default to {isDefault}.
GET /api/v1/admin/Languages/Default.Default() Get default values for a new language · Call operation Default #
Ask an LLM
“What defaults does the admin pre-fill for a language before I add one?”
“Where do I get a blank language template?”
Tell an agent
Get the default language template.
Show me the pre-filled defaults for a new language record.
DELETE /api/v1/admin/languages/delete Bulk delete languages by ID · Languages delete route #
Ask an LLM
“How do I delete several languages in one request?”
“Can I bulk-remove languages by passing their IDs?”
Tell an agent destructive · confirm first
Bulk delete languages {ids}.
Permanently remove the languages with IDs {ids}.
GET /api/v1/admin/languages({key})/customproperties({custompropertyKey}) Get a custom property on a language · Languages get custom property by key and custompropertykey #
Ask an LLM
“How can I read one custom property stored on a language?”
“Can I expand related data on a language's custom property?”
Tell an agent
Show custom property {custompropertyKey} on language {key}.
Fetch language {key}'s custom property {custompropertyKey} with {expand} expanded.
GET /api/v1/admin/languages({key})/websitelanguages({websitelanguageKey}) Get a website's use of a language · Languages get website language by key and websitelanguagekey #
Ask an LLM
“Which website-language assignment links a language to a site?”
“Can I fetch one website language record through its language?”
Tell an agent
Show website language {websitelanguageKey} for language {key}.
Fetch language {key}'s website assignment {websitelanguageKey}, selecting {select}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/optimizely/refs/heads/main/openapi/optimizely-languages-api-openapi.yml

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-languages-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.

GitHub Google LinkedIn

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

OpenAPI Specification

optimizely-languages-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: admin-v1
  title: Admin API V1 Languages API
servers:
- url: https://dogfood.commerce.insitesandbox.com
security: []
tags:
- name: Languages
paths:
  /api/v1/admin/Languages:
    get:
      tags:
      - Languages
      summary: Returns the EntitySet Languages
      operationId: Languages_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:
      - Languages
      summary: Post a new entity to EntitySet Languages
      operationId: Languages_Post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Insite.Data.Entities.Language'
        description: The entity to post
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/Languages({id}):
    get:
      tags:
      - Languages
      summary: Returns the entity with the key from Languages
      operationId: Languages_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:
      - Languages
      summary: Replace entity in EntitySet Languages
      operationId: Languages_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.Language'
        description: The entity to put
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
    delete:
      tags:
      - Languages
      summary: Delete entity in EntitySet Languages
      operationId: Languages_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:
      - Languages
      summary: Update entity in EntitySet Languages
      operationId: Languages_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.Language'
        description: The entity to patch
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/Languages/Default.Default():
    get:
      tags:
      - Languages
      summary: Call operation Default
      operationId: Languages_Default
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/languages/delete:
    delete:
      tags:
      - Languages
      operationId: Languages_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: Languages delete route
      x-summary-source: derived
  /api/v1/admin/languages({key})/customproperties({custompropertyKey}):
    get:
      tags:
      - Languages
      operationId: Languages_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: Languages get custom property by key and custompropertykey
      x-summary-source: derived
  /api/v1/admin/languages({key})/websitelanguages({websitelanguageKey}):
    get:
      tags:
      - Languages
      operationId: Languages_GetWebsiteLanguageByKeyAndWebsitelanguagekey
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: websitelanguageKey
        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: Languages get website language by key and websitelanguagekey
      x-summary-source: derived
components:
  schemas:
    Insite.Data.Entities.Language:
      required:
      - languageCode
      - description
      - alternateLanguages
      - imageFilePath
      - cultureCode
      - languageTag
      type: object
      properties:
        id:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        languageCode:
          maxLength: 50
          minLength: 0
          type: string
        description:
          maxLength: 255
          minLength: 0
          type: string
        alternateLanguages:
          maxLength: 255
          minLength: 0
          type: string
        hasDeviceSpecificContent:
          type: boolean
        hasPersonaSpecificContent:
          type: boolean
        imageFilePath:
          maxLength: 1024
          minLength: 0
          type: string
        isDefault:
          type: boolean
        cultureCode:
          maxLength: 50
          minLength: 0
          type: string
        currencyPositioning:
          type: string
        languageTag:
          maxLength: 256
          minLength: 0
          type: string
        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