# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Component Creatives Components API
  version: 1.0.0
extends: openapi/mediamath-components-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/component_creatives/v3.0/components'].get
  update:
    x-apievangelist-phrasing:
      intent: List native creative components
      effect: read
      questions:
      - Which components can native creatives be built from?
      - What component types are defined in the system?
      instructions:
      - text: List all creative components.
      - text: Show every component available for native creatives.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v3.0/components'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a creative component
      effect: write
      questions:
      - How do I define a new native creative component with a character limit?
      - Who is allowed to create components?
      instructions:
      - text: Create component {name} of value type {type} with a {limit} character limit.
        slots:
          name: requestBody.component_human_name
          type: requestBody.value_type_name
          limit: requestBody.char_limit
      - text: Define a new component named {name} with value type {type}.
        slots:
          name: requestBody.component_human_name
          type: requestBody.value_type_name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v3.0/components/{component_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a creative component
      effect: read
      questions:
      - What are the settings of a specific component?
      - Can I look up one component by its ID?
      instructions:
      - text: Get component {component}.
        slots:
          component: path.component_id
      - text: Show the settings of component {component}.
        slots:
          component: path.component_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/component_creatives/v3.0/components/{component_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a creative component
      effect: write
      questions:
      - Can I change a component's character limit or disable it?
      - Is a component's value type editable after creation?
      instructions:
      - text: Set the character limit on component {component} to {limit}.
        slots:
          component: path.component_id
          limit: requestBody.char_limit
      - text: Disable component {component}.
        slots:
          component: path.component_id
      method: generated
      generated: '2026-10-01'