Optimizely · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Optimizely CMP Open API Documentation Templates API

3 actions 3 updates phrasing extends openapi/optimizely-templates-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Optimizely's API. It is a proposal applied on top of the contract, not a document Optimizely publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 3

$.info

$.paths['/templates'].get

$.paths['/templates/{template_id}'].get

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Optimizely CMP Open API Documentation Templates API
  version: 1.0.0
extends: openapi/optimizely-templates-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: 2
- target: $.paths['/templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List templates
      effect: read
      questions:
      - What templates are available to start new work from in Optimizely?
      - Can I include inactive templates when listing them?
      - Which templates apply to a particular kind of item?
      instructions:
      - text: List templates matching {search}.
        slots:
          search: query.search
      - text: List templates applicable to {applicable_to}, including inactive ones.
        slots:
          applicable_to: query.applicable_to
      - text: Get {page_size} templates starting at offset {offset}.
        slots:
          page_size: query.page_size
          offset: query.offset
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/{template_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a template by id
      effect: read
      questions:
      - What does a specific template contain?
      - Can I fetch one template's details by its id?
      instructions:
      - text: Get template {template_id}.
        slots:
          template_id: path.template_id
      - text: Show me the details of template {template_id}.
        slots:
          template_id: path.template_id
      method: generated
      generated: '2026-09-26'