# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Campaigns Agencies API
  version: 1.0.0
extends: openapi/mediamath-agencies-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: 7
- target: $.paths['/agencies'].get
  update:
    x-apievangelist-phrasing:
      intent: List agencies
      effect: read
      questions:
      - Which agencies exist under my MediaMath organizations?
      - Can I search agencies by name?
      instructions:
      - text: List all agencies.
      - text: Search agencies matching {query}.
        slots:
          query: query.q
      method: generated
      generated: '2026-10-01'
- target: $.paths['/agencies'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an agency
      effect: write
      questions:
      - How do I add a new agency?
      - Can I set up an agency through the API?
      instructions:
      - text: Create a new agency.
      - text: Set up a brand-new agency.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/agencies/{agency_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an agency
      effect: read
      questions:
      - What details are stored for a specific agency?
      - Can I look up one agency by its ID?
      instructions:
      - text: Get agency {agency}.
        slots:
          agency: path.agency_id
      - text: Show the details of agency {agency}.
        slots:
          agency: path.agency_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/agencies/{agency_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update an agency
      effect: write
      questions:
      - How do I edit an existing agency's details?
      - Can I change an agency record by ID?
      instructions:
      - text: Update agency {agency}.
        slots:
          agency: path.agency_id
      - text: Edit the details of agency {agency}.
        slots:
          agency: path.agency_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/agencies/{agency_id}/history'].get
  update:
    x-apievangelist-phrasing:
      intent: View an agency's change history
      effect: read
      questions:
      - Who changed this agency and when?
      - Where is the audit trail for one agency?
      instructions:
      - text: Show the audit log for agency {agency}.
        slots:
          agency: path.agency_id
      - text: List the changes made to agency {agency}.
        slots:
          agency: path.agency_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/agencies/{agency_id}/permissions'].get
  update:
    x-apievangelist-phrasing:
      intent: List users with access to an agency
      effect: read
      questions:
      - Which users have permissions on a given agency?
      - Who can access this agency's account?
      instructions:
      - text: List user permissions for agency {agency}.
        slots:
          agency: path.agency_id
      - text: Show who has access to agency {agency}.
        slots:
          agency: path.agency_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/audit_log/agencies'].post
  update:
    x-apievangelist-phrasing:
      intent: View change history for several agencies
      effect: read
      questions:
      - Can I pull audit logs for multiple agencies at once?
      - What changed across a set of agencies?
      instructions:
      - text: Get the audit logs for agencies {ids}.
        slots:
          ids: requestBody.id
      - text: List the changes made across agencies {ids}.
        slots:
          ids: requestBody.id
      method: generated
      generated: '2026-10-01'