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