API Evangelist conversational phrasing for Admin API V1 Style Traits API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Admin API V1 Style Traits API
  version: 1.0.0
extends: openapi/optimizely-style-traits-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 10
- target: $.paths['/api/v1/admin/StyleTraits'].get
  update:
    x-apievangelist-phrasing:
      intent: List product style traits
      effect: read
      questions:
      - Which style traits like color or size are defined for my product variants?
      - Can I filter style traits by style class?
      - How do I get a count of all style traits?
      instructions:
      - text: List all style traits.
      - text: Find style traits matching {filter}.
        slots:
          filter: query.$filter
      - text: Show style traits sorted by {orderby}, skipping {skip}.
        slots:
          orderby: query.$orderby
          skip: query.$skip
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/admin/StyleTraits'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a style trait
      effect: write
      questions:
      - 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?
      instructions:
      - text: Create style trait {name} in style class {styleClassId} with unselected text {unselectedValue}.
        slots:
          name: requestBody.name
          styleClassId: requestBody.styleClassId
          unselectedValue: requestBody.unselectedValue
      - text: Add a style trait {name} described as {description} shown as {displayType}.
        slots:
          name: requestBody.name
          description: requestBody.description
          displayType: requestBody.displayType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/admin/StyleTraits({id})'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one style trait
      effect: read
      questions:
      - What are the display settings of a specific style trait?
      - How many swatches does a given style trait show?
      instructions:
      - text: Get style trait {id}.
        slots:
          id: path.id
      - text: Show style trait {id} with {expand} expanded.
        slots:
          id: path.id
          expand: query.$expand
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/admin/StyleTraits({id})'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a style trait record
      effect: write
      questions:
      - How do I overwrite every field of a style trait at once?
      - Can I fully replace a style trait definition?
      instructions:
      - text: Replace style trait {id} with name {name} and description {description}.
        slots:
          id: path.id
          name: requestBody.name
          description: requestBody.description
      - text: Overwrite the whole record for style trait {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/admin/StyleTraits({id})'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a style trait
      effect: destructive
      questions:
      - How do I remove a single style trait?
      - Can I delete a style trait only if nobody changed it since I read it?
      instructions:
      - text: Delete style trait {id}.
        slots:
          id: path.id
      - text: Delete style trait {id} if its ETag matches {ifMatch}.
        slots:
          id: path.id
          ifMatch: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/admin/StyleTraits({id})'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update a style trait
      effect: write
      questions:
      - Can I change only the sort order of a style trait?
      - How do I switch a style trait to show text alongside swatches?
      instructions:
      - text: Set the sort order of style trait {id} to {sortOrder}.
        slots:
          id: path.id
          sortOrder: requestBody.sortOrder
      - text: Show {numberOfSwatchesVisible} swatches for style trait {id}.
        slots:
          numberOfSwatchesVisible: requestBody.numberOfSwatchesVisible
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/admin/StyleTraits/Default.Default()'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the default style trait template
      effect: read
      questions:
      - What default values does a new style trait start with?
      - Is there a blank style trait template to fetch?
      instructions:
      - text: Fetch the default style trait template.
      - text: Get default values for a new style trait.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/admin/styletraits/delete'].delete
  update:
    x-apievangelist-phrasing:
      intent: Bulk delete style traits
      effect: destructive
      questions:
      - How do I delete several style traits in one request?
      - Can I remove multiple style traits by passing their IDs?
      instructions:
      - text: Bulk delete style traits {ids}.
        slots:
          ids: query.ids
      - text: 'Remove all these style traits at once: {ids}.'
        slots:
          ids: query.ids
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/admin/styletraits({key})/customproperties({custompropertyKey})'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom property of a style trait
      effect: read
      questions:
      - How do I read a custom property on a style trait?
      - Can I fetch one custom field value from a style trait?
      instructions:
      - text: Get custom property {custompropertyKey} of style trait {key}.
        slots:
          custompropertyKey: path.custompropertyKey
          key: path.key
      - text: Show custom field {custompropertyKey} on style trait {key}.
        slots:
          custompropertyKey: path.custompropertyKey
          key: path.key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/admin/styletraits({key})/styletraitvalues({styletraitvalueKey})'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one value of a style trait
      effect: read
      questions:
      - 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?
      instructions:
      - text: Get value {styletraitvalueKey} of style trait {key}.
        slots:
          styletraitvalueKey: path.styletraitvalueKey
          key: path.key
      - text: Show option {styletraitvalueKey} under style trait {key}.
        slots:
          styletraitvalueKey: path.styletraitvalueKey
          key: path.key
      method: generated
      generated: '2026-09-26'