# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Campaigns User Permissions API
  version: 1.0.0
extends: openapi/mediamath-user-permissions-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: 10
- target: $.paths['/users/{user_id}/permissions'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a user's permissions
      effect: write
      questions:
      - How do I grant a user access to more advertisers or campaigns?
      - Can I change what a user is permitted to see in one request?
      instructions:
      - text: Set permissions {permissions} for user {user_id}.
        slots:
          permissions: requestBody.permissions
          user_id: path.user_id
      - text: Update user {user_id}'s access to {permissions}.
        slots:
          user_id: path.user_id
          permissions: requestBody.permissions
      method: generated
      generated: '2026-10-01'
- target: $.paths['/permissions/{user_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's permissions
      effect: read
      questions:
      - What can a given user access across organizations, agencies and campaigns?
      - Can I check a user's permissions filtered to one advertiser?
      instructions:
      - text: List all permissions for user {user_id}.
        slots:
          user_id: path.user_id
      - text: Show user {user_id}'s permissions for advertiser {advertiser_id}.
        slots:
          user_id: path.user_id
          advertiser_id: query.advertiser_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/permissions/{user_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a user's permissions on specific entities
      effect: read
      questions:
      - Does this user have access to a particular set of campaigns and strategies?
      - Can I post a list of entities and get back a user's permissions on just those?
      instructions:
      - text: Check user {user_id}'s permissions on campaigns {campaigns}.
        slots:
          user_id: path.user_id
          campaigns: requestBody.campaigns
      - text: Get user {user_id}'s permissions for advertisers {advertisers} and strategies {strategies}.
        slots:
          user_id: path.user_id
          advertisers: requestBody.advertisers
          strategies: requestBody.strategies
      method: generated
      generated: '2026-10-01'
- target: $.paths['/permissions/{user_id}/organizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's organization permissions
      effect: read
      questions:
      - Which organizations does a user have access to?
      - Can I list only the organization-level permissions for a user?
      instructions:
      - text: List the organizations user {user_id} can access.
        slots:
          user_id: path.user_id
      - text: Show organization permissions for user {user_id}.
        slots:
          user_id: path.user_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/permissions/{user_id}/agencies'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's agency permissions
      effect: read
      questions:
      - Which agencies is a user permitted to work with?
      - Is there a way to see just agency-level access for one user?
      instructions:
      - text: List the agencies user {user_id} can access.
        slots:
          user_id: path.user_id
      - text: Show agency permissions for user {user_id}.
        slots:
          user_id: path.user_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/permissions/{user_id}/advertisers'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's advertiser permissions
      effect: read
      questions:
      - Which advertisers can this user manage?
      - Can I page through every advertiser a user has rights on?
      instructions:
      - text: List the advertisers user {user_id} can access.
        slots:
          user_id: path.user_id
      - text: Show advertiser permissions for user {user_id}.
        slots:
          user_id: path.user_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/permissions/{user_id}/campaigns'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's campaign permissions
      effect: read
      questions:
      - Which campaigns does a particular user have access to?
      - How do I see every campaign permission for one user?
      instructions:
      - text: List the campaigns user {user_id} can access.
        slots:
          user_id: path.user_id
      - text: Show campaign permissions for user {user_id}.
        slots:
          user_id: path.user_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/permissions/{user_id}/strategies'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's strategy permissions
      effect: read
      questions:
      - Which strategies is a user allowed to edit or view?
      - Can I list strategy-level access for a single user?
      instructions:
      - text: List the strategies user {user_id} can access.
        slots:
          user_id: path.user_id
      - text: Show strategy permissions for user {user_id}.
        slots:
          user_id: path.user_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/permissions/{user_id}/v2format'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's permissions in V2 format
      effect: read
      questions:
      - Can I get a user's permissions in the V2 response format?
      - What does the V2-format permission listing look like for a user?
      instructions:
      - text: List user {user_id}'s permissions in V2 format.
        slots:
          user_id: path.user_id
      - text: Get V2-format permissions for user {user_id}.
        slots:
          user_id: path.user_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/permissions/{user_id}/v2format'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a user's entity permissions in V2 format
      effect: read
      questions:
      - Can I check a user's access to specific advertisers and get V2-format output?
      - Which of these organizations or agencies can the user access, in V2 format?
      instructions:
      - text: Check user {user_id}'s V2-format permissions on advertisers {advertisers}.
        slots:
          user_id: path.user_id
          advertisers: requestBody.advertisers
      - text: Get V2-format permissions for user {user_id} on organizations {organizations} and agencies {agencies}.
        slots:
          user_id: path.user_id
          organizations: requestBody.organizations
          agencies: requestBody.agencies
      method: generated
      generated: '2026-10-01'