Optimizely

Optimizely Style Traits API

The Style Traits API from Optimizely — 6 operation(s) for style traits.

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/StyleTraits List product style traits · Returns the EntitySet StyleTraits #
Ask an LLM
“Which style traits like color or size are defined for my product variants?”
“Can I filter style traits by style class?”
Tell an agent
List all style traits.
Find style traits matching {filter}.
POST /api/v1/admin/StyleTraits Create a style trait · Post a new entity to EntitySet StyleTraits #
Ask an LLM
“How do I add a new style trait such as Color to a style class?”
“Can I choose a swatch display type when creating a style trait?”
Tell an agent
Create style trait {name} in style class {styleClassId} with unselected text {unselectedValue}.
Add a style trait {name} described as {description} shown as {displayType}.
GET /api/v1/admin/StyleTraits({id}) Get one style trait · Returns the entity with the key from StyleTraits #
Ask an LLM
“What are the display settings of a specific style trait?”
“How many swatches does a given style trait show?”
Tell an agent
Get style trait {id}.
Show style trait {id} with {expand} expanded.
PUT /api/v1/admin/StyleTraits({id}) Replace a style trait record · Replace entity in EntitySet StyleTraits #
Ask an LLM
“How do I overwrite every field of a style trait at once?”
“Can I fully replace a style trait definition?”
Tell an agent
Replace style trait {id} with name {name} and description {description}.
Overwrite the whole record for style trait {id}.
DELETE /api/v1/admin/StyleTraits({id}) Delete a style trait · Delete entity in EntitySet StyleTraits #
Ask an LLM
“How do I remove a single style trait?”
“Can I delete a style trait only if nobody changed it since I read it?”
Tell an agent destructive · confirm first
Delete style trait {id}.
Delete style trait {id} if its ETag matches {ifMatch}.
PATCH /api/v1/admin/StyleTraits({id}) Partially update a style trait · Update entity in EntitySet StyleTraits #
Ask an LLM
“Can I change only the sort order of a style trait?”
“How do I switch a style trait to show text alongside swatches?”
Tell an agent
Set the sort order of style trait {id} to {sortOrder}.
Show {numberOfSwatchesVisible} swatches for style trait {id}.
GET /api/v1/admin/StyleTraits/Default.Default() Get the default style trait template · Call operation Default #
Ask an LLM
“What default values does a new style trait start with?”
“Is there a blank style trait template to fetch?”
Tell an agent
Fetch the default style trait template.
Get default values for a new style trait.
DELETE /api/v1/admin/styletraits/delete Bulk delete style traits · Style traits delete route #
Ask an LLM
“How do I delete several style traits in one request?”
“Can I remove multiple style traits by passing their IDs?”
Tell an agent destructive · confirm first
Bulk delete style traits {ids}.
Remove all these style traits at once: {ids}.
GET /api/v1/admin/styletraits({key})/customproperties({custompropertyKey}) Get a custom property of a style trait · Style traits get custom property by key and custompropertykey #
Ask an LLM
“How do I read a custom property on a style trait?”
“Can I fetch one custom field value from a style trait?”
Tell an agent
Get custom property {custompropertyKey} of style trait {key}.
Show custom field {custompropertyKey} on style trait {key}.
GET /api/v1/admin/styletraits({key})/styletraitvalues({styletraitvalueKey}) Get one value of a style trait · Style traits get style trait value by key and styletraitvaluekey #
Ask an LLM
“How do I look up a specific option, like Red, under a style trait?”
“Can I fetch a single style trait value by its key?”
Tell an agent
Get value {styletraitvalueKey} of style trait {key}.
Show option {styletraitvalueKey} under style trait {key}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/optimizely/refs/heads/main/openapi/optimizely-style-traits-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-style-traits-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-style-traits-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: admin-v1
  title: Admin API V1 Style Traits API
servers:
- url: https://dogfood.commerce.insitesandbox.com
security: []
tags:
- name: Style Traits
paths:
  /api/v1/admin/StyleTraits:
    get:
      tags:
      - Style Traits
      summary: Returns the EntitySet StyleTraits
      operationId: StyleTraits_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:
      - Style Traits
      summary: Post a new entity to EntitySet StyleTraits
      operationId: StyleTraits_Post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Insite.Data.Entities.StyleTrait'
        description: The entity to post
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/StyleTraits({id}):
    get:
      tags:
      - Style Traits
      summary: Returns the entity with the key from StyleTraits
      operationId: StyleTraits_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:
      - Style Traits
      summary: Replace entity in EntitySet StyleTraits
      operationId: StyleTraits_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.StyleTrait'
        description: The entity to put
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
    delete:
      tags:
      - Style Traits
      summary: Delete entity in EntitySet StyleTraits
      operationId: StyleTraits_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:
      - Style Traits
      summary: Update entity in EntitySet StyleTraits
      operationId: StyleTraits_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.StyleTrait'
        description: The entity to patch
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/StyleTraits/Default.Default():
    get:
      tags:
      - Style Traits
      summary: Call operation Default
      operationId: StyleTraits_Default
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/styletraits/delete:
    delete:
      tags:
      - Style Traits
      operationId: StyleTraits_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: Style traits delete route
      x-summary-source: derived
  /api/v1/admin/styletraits({key})/customproperties({custompropertyKey}):
    get:
      tags:
      - Style Traits
      operationId: StyleTraits_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: Style traits get custom property by key and custompropertykey
      x-summary-source: derived
  /api/v1/admin/styletraits({key})/styletraitvalues({styletraitvalueKey}):
    get:
      tags:
      - Style Traits
      operationId: StyleTraits_GetStyleTraitValueByKeyAndStyletraitvaluekey
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: styletraitvalueKey
        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: Style traits get style trait value by key and styletraitvaluekey
      x-summary-source: derived
components:
  schemas:
    Insite.Data.Entities.StyleTrait:
      required:
      - name
      - unselectedValue
      - description
      type: object
      properties:
        id:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        styleClassId:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        name:
          maxLength: 255
          minLength: 0
          type: string
        unselectedValue:
          maxLength: 255
          minLength: 0
          type: string
        sortOrder:
          format: int32
          type: integer
        description:
          maxLength: 512
          minLength: 0
          type: string
        displayType:
          type: string
        numberOfSwatchesVisible:
          format: int32
          type: integer
        displayTextWithSwatch:
          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