# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Campaigns Enterprise Controls API
  version: 1.0.0
extends: openapi/mediamath-enterprise-controls-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['/entity_groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List entity groups
      effect: read
      questions:
      - Which enterprise entity groups are set up?
      - Can I see all entity groups used for controls?
      instructions:
      - text: List entity groups.
      - text: Show all enterprise entity groups.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/entity_groups/{entity_group_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an entity group
      effect: read
      questions:
      - What does a particular entity group contain?
      - Can I look up an entity group by ID?
      instructions:
      - text: Get entity group {entity_group_id}.
        slots:
          entity_group_id: path.entity_group_id
      - text: Show details of entity group {entity_group_id}.
        slots:
          entity_group_id: path.entity_group_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/entity_groups/{entity_group_id}/controls/{entity_type}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an entity group's controls by type
      effect: read
      questions:
      - What enterprise controls apply to campaigns in an entity group?
      - Can I see an entity group's controls for one entity type?
      instructions:
      - text: Get {entity_type} controls for entity group {entity_group_id}.
        slots:
          entity_type: path.entity_type
          entity_group_id: path.entity_group_id
      - text: Show the controls entity group {entity_group_id} enforces on {entity_type}.
        slots:
          entity_group_id: path.entity_group_id
          entity_type: path.entity_type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/entity_groups/{entity_group_id}/history'].get
  update:
    x-apievangelist-phrasing:
      intent: View an entity group's change history
      effect: read
      questions:
      - Who changed this entity group's controls?
      - Can I page through the audit log of an entity group?
      instructions:
      - text: Show the change history for entity group {entity_group_id}.
        slots:
          entity_group_id: path.entity_group_id
      - text: Get the audit log of entity group {entity_group_id}.
        slots:
          entity_group_id: path.entity_group_id
      method: generated
      generated: '2026-10-01'