Optimizely Entity Definitions API

The Entity Definitions API from Optimizely — 6 operation(s) for entity definitions.

Documentation GitHub OpenAPI

Operations 6

GET /api/v1/admin/EntityDefinitions Returns the EntitySet EntityDefinitions #

GET /api/v1/admin/EntityDefinitions('{name}') Returns the entity with the key from EntityDefinitions #

GET /api/v1/admin/EntityDefinitions/Default.PropertyValidations(entityName='{entityName}') Call operation PropertyValidations #

GET /api/v1/admin/EntityDefinitions/Default.DisplayNameFormats() Call operation DisplayNameFormats #

GET /api/v1/admin/entitydefinitions/PropertyValidations(entityName='{entityName}') #

GET /api/v1/admin/entitydefinitions/displayNameFormats #

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/optimizely/refs/heads/main/openapi/optimizely-entity-definitions-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-entity-definitions-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 email required.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  version: admin-v1
  title: Admin API V1 Entity Definitions API
servers:
- url: https://dogfood.commerce.insitesandbox.com
security: []
tags:
- name: Entity Definitions
paths:
  /api/v1/admin/EntityDefinitions:
    get:
      tags:
      - Entity Definitions
      summary: Returns the EntitySet EntityDefinitions
      operationId: EntityDefinitions_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
  /api/v1/admin/EntityDefinitions('{name}'):
    get:
      tags:
      - Entity Definitions
      summary: Returns the entity with the key from EntityDefinitions
      operationId: EntityDefinitions_GetByName
      parameters:
      - name: name
        in: path
        description: 'key: name'
        required: true
        schema:
          type: string
      - 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
  /api/v1/admin/EntityDefinitions/Default.PropertyValidations(entityName='{entityName}'):
    get:
      tags:
      - Entity Definitions
      summary: Call operation  PropertyValidations
      operationId: EntityDefinitions_GetPropertyValidationsByEntityname_1
      parameters:
      - name: entityName
        in: path
        description: 'parameter: entityName'
        required: true
        schema:
          type: string
      - 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
  /api/v1/admin/EntityDefinitions/Default.DisplayNameFormats():
    get:
      tags:
      - Entity Definitions
      summary: Call operation  DisplayNameFormats
      operationId: EntityDefinitions_GetDisplayNameFormats_1
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
  /api/v1/admin/entitydefinitions/PropertyValidations(entityName='{entityName}'):
    get:
      tags:
      - Entity Definitions
      operationId: EntityDefinitions_GetPropertyValidationsByEntityname_2
      parameters:
      - name: entityName
        in: path
        required: true
        schema:
          type: string
      - 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
  /api/v1/admin/entitydefinitions/displayNameFormats:
    get:
      tags:
      - Entity Definitions
      operationId: EntityDefinitions_GetDisplayNameFormats_2
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
components:
  securitySchemes:
    access_token:
      type: apiKey
      description: Token used to access storefront API.
      name: access_token
      in: query