# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Campaigns General API
  version: 1.0.0
extends: openapi/mediamath-general-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['/healthcheck'].get
  update:
    x-apievangelist-phrasing:
      intent: Check API availability
      effect: read
      questions:
      - Is the MediaMath API up right now?
      - How can I confirm the service is available before running a job?
      instructions:
      - text: Run a health check on the API.
      - text: Check whether the service is available.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/roles'].get
  update:
    x-apievangelist-phrasing:
      intent: List user roles
      effect: read
      questions:
      - What user roles exist on the platform?
      - Which roles can I assign to a user?
      instructions:
      - text: List all user roles.
      - text: Show the available roles.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search organizations, agencies and advertisers by name
      effect: read
      questions:
      - How do I find an advertiser or agency when I only know part of its name?
      - Can I limit an entity search to active ones only?
      instructions:
      - text: Search for organizations, agencies or advertisers named {name}.
        slots:
          name: query.name
      - text: Find active entities matching {name}, up to {limit} results.
        slots:
          name: query.name
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/target_values'].get
  update:
    x-apievangelist-phrasing:
      intent: List targeting values
      effect: read
      questions:
      - What targeting values are available to use on strategies?
      - Can I look up a targeting value by name?
      instructions:
      - text: List all targeting values.
      - text: Find targeting values named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-10-01'