Optimizely

Optimizely Translation Dictionaries API

The Translation Dictionaries API from Optimizely — 5 operation(s) for translation dictionaries.

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/TranslationDictionaries List translation dictionary entries · Returns the EntitySet TranslationDictionaries #
Ask an LLM
“Which storefront labels have translations in my translation dictionary?”
“Can I filter translations to one language?”
Tell an agent
List all translation dictionary entries.
Find translation entries matching {filter}.
POST /api/v1/admin/TranslationDictionaries Add a translation for a keyword · Post a new entity to EntitySet TranslationDictionaries #
Ask an LLM
“How do I add a translated label for a storefront keyword?”
“Can I add a translation for a specific language?”
Tell an agent
Add translation {translation} for keyword {keyword} from source {source}.
Create a {languageId} translation of {keyword} as {translation} with source {source}.
GET /api/v1/admin/TranslationDictionaries({id}) Get one translation entry · Returns the entity with the key from TranslationDictionaries #
Ask an LLM
“What is the stored translation for a specific dictionary entry?”
“How do I look up one translation record by ID?”
Tell an agent
Get translation entry {id}.
Show dictionary entry {id} with {expand} expanded.
PUT /api/v1/admin/TranslationDictionaries({id}) Replace a translation entry · Replace entity in EntitySet TranslationDictionaries #
Ask an LLM
“How do I overwrite a translation entry's keyword, source and text together?”
“Can I fully replace a translation dictionary record?”
Tell an agent
Replace translation entry {id} with keyword {keyword}, source {source}, translation {translation}.
Overwrite the whole translation record {id}.
DELETE /api/v1/admin/TranslationDictionaries({id}) Delete a translation entry · Delete entity in EntitySet TranslationDictionaries #
Ask an LLM
“How do I remove one translation from the dictionary?”
“Can I delete a translation only if the ETag still matches?”
Tell an agent destructive · confirm first
Delete translation entry {id}.
Delete translation {id} if its ETag is {ifMatch}.
PATCH /api/v1/admin/TranslationDictionaries({id}) Fix the text of a translation · Update entity in EntitySet TranslationDictionaries #
Ask an LLM
“Can I correct just the translated text of an existing entry?”
“How do I change the language on one translation record?”
Tell an agent
Change the translated text of entry {id} to {translation}.
Set the language of translation entry {id} to {languageId}.
GET /api/v1/admin/TranslationDictionaries/Default.Default() Get the default translation entry template · Call operation Default #
Ask an LLM
“What default values does a new translation entry start with?”
“Is there a blank translation dictionary template?”
Tell an agent
Fetch the default translation entry template.
Get default values for a new dictionary entry.
DELETE /api/v1/admin/translationdictionaries/delete Bulk delete translation entries · Translation dictionaries delete route #
Ask an LLM
“How do I delete many translations at once?”
“Can I remove several dictionary entries by passing their IDs?”
Tell an agent destructive · confirm first
Bulk delete translation entries {ids}.
Remove all these translations in one call: {ids}.
GET /api/v1/admin/translationdictionaries({key})/customproperties({custompropertyKey}) Get a custom property of a translation entry · Translation dictionaries get custom property by key and custompropertykey #
Ask an LLM
“How do I read a custom property on a translation entry?”
“Can I fetch one custom field from a dictionary record?”
Tell an agent
Get custom property {custompropertyKey} of translation entry {key}.
Show custom field {custompropertyKey} on dictionary entry {key}.
GET /api/v1/translationdictionaries Look up storefront translation entries · Translation dictionaries V1 get async #
Ask an LLM
“How do I find the translated text for a storefront label in another language?”
“Can I search translation dictionaries by keyword and language code?”
Tell an agent
Search translations for keyword {keyWord} in language {languageCode}.
List translation dictionary entries from source {source}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/optimizely/refs/heads/main/openapi/optimizely-translation-dictionaries-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-translation-dictionaries-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-translation-dictionaries-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: admin-v1
  title: Admin API V1 Translation Dictionaries API
servers:
- url: https://dogfood.commerce.insitesandbox.com
security: []
tags:
- name: Translation Dictionaries
paths:
  /api/v1/admin/TranslationDictionaries:
    get:
      tags:
      - Translation Dictionaries
      summary: Returns the EntitySet TranslationDictionaries
      operationId: TranslationDictionaries_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:
      - Translation Dictionaries
      summary: Post a new entity to EntitySet TranslationDictionaries
      operationId: TranslationDictionaries_Post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Insite.Data.Entities.TranslationDictionary'
        description: The entity to post
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/TranslationDictionaries({id}):
    get:
      tags:
      - Translation Dictionaries
      summary: Returns the entity with the key from TranslationDictionaries
      operationId: TranslationDictionaries_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:
      - Translation Dictionaries
      summary: Replace entity in EntitySet TranslationDictionaries
      operationId: TranslationDictionaries_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.TranslationDictionary'
        description: The entity to put
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
    delete:
      tags:
      - Translation Dictionaries
      summary: Delete entity in EntitySet TranslationDictionaries
      operationId: TranslationDictionaries_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:
      - Translation Dictionaries
      summary: Update entity in EntitySet TranslationDictionaries
      operationId: TranslationDictionaries_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.TranslationDictionary'
        description: The entity to patch
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/TranslationDictionaries/Default.Default():
    get:
      tags:
      - Translation Dictionaries
      summary: Call operation Default
      operationId: TranslationDictionaries_Default
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/translationdictionaries/delete:
    delete:
      tags:
      - Translation Dictionaries
      operationId: TranslationDictionaries_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: Translation dictionaries delete route
      x-summary-source: derived
  /api/v1/admin/translationdictionaries({key})/customproperties({custompropertyKey}):
    get:
      tags:
      - Translation Dictionaries
      operationId: TranslationDictionaries_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: Translation dictionaries get custom property by key and custompropertykey
      x-summary-source: derived
  /api/v1/translationdictionaries:
    get:
      tags:
      - Translation Dictionaries
      operationId: TranslationDictionariesV1_GetAsync
      parameters:
      - name: parameter.keyWord
        in: query
        required: false
        schema:
          type: string
      - name: parameter.source
        in: query
        required: false
        schema:
          type: string
      - name: parameter.languageCode
        in: query
        required: false
        schema:
          type: string
      - name: parameter.page
        in: query
        required: false
        schema:
          type: integer
          format: int32
      - name: parameter.pageSize
        in: query
        required: false
        schema:
          type: integer
          format: int32
      - name: parameter.sort
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Insite.Websites.WebApi.V1.ApiModels.TranslationDictionaryCollectionModel'
            text/json:
              schema:
                $ref: '#/components/schemas/Insite.Websites.WebApi.V1.ApiModels.TranslationDictionaryCollectionModel'
            application/xml:
              schema:
                $ref: '#/components/schemas/Insite.Websites.WebApi.V1.ApiModels.TranslationDictionaryCollectionModel'
            text/xml:
              schema:
                $ref: '#/components/schemas/Insite.Websites.WebApi.V1.ApiModels.TranslationDictionaryCollectionModel'
            text/html:
              schema:
                $ref: '#/components/schemas/Insite.Websites.WebApi.V1.ApiModels.TranslationDictionaryCollectionModel'
      summary: Translation dictionaries V1 get async
      x-summary-source: derived
components:
  schemas:
    Insite.Data.Entities.TranslationDictionary:
      required:
      - source
      - keyword
      - translation
      type: object
      properties:
        id:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        languageId:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        source:
          maxLength: 50
          minLength: 0
          type: string
        keyword:
          maxLength: 255
          minLength: 0
          type: string
        translation:
          maxLength: 255
          minLength: 0
          type: string
        createdOn:
          format: date-time
          type: string
        createdBy:
          type: string
        modifiedOn:
          format: date-time
          type: string
        modifiedBy:
          type: string
    Insite.Core.WebApi.PaginationModel:
      type: object
      properties:
        currentPage:
          format: int32
          type: integer
        page:
          format: int32
          type: integer
        pageSize:
          format: int32
          type: integer
        defaultPageSize:
          format: int32
          type: integer
        totalItemCount:
          format: int32
          type: integer
        numberOfPages:
          format: int32
          type: integer
        pageSizeOptions:
          type: array
          items:
            format: int32
            type: integer
        sortOptions:
          type: array
          items:
            $ref: '#/components/schemas/Insite.Core.WebApi.SortOptionModel'
        sortType:
          type: string
        nextPageUri:
          type: string
        prevPageUri:
          type: string
        nextPageToken:
          type: string
    Insite.Websites.WebApi.V1.ApiModels.TranslationDictionaryModel:
      type: object
      properties:
        keyword:
          type: string
        source:
          type: string
        translation:
          type: string
        languageId:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        languageCode:
          type: string
        properties:
          type: object
          additionalProperties:
            type: string
    Insite.Core.WebApi.SortOptionModel:
      type: object
      properties:
        displayName:
          type: string
        sortType:
          type: string
    Insite.Websites.WebApi.V1.ApiModels.TranslationDictionaryCollectionModel:
      type: object
      properties:
        uri:
          type: string
        translationDictionaries:
          type: array
          items:
            $ref: '#/components/schemas/Insite.Websites.WebApi.V1.ApiModels.TranslationDictionaryModel'
        pagination:
          $ref: '#/components/schemas/Insite.Core.WebApi.PaginationModel'
        properties:
          type: object
          additionalProperties:
            type: string
  securitySchemes:
    access_token:
      type: apiKey
      description: Token used to access storefront API.
      name: access_token
      in: query