# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Campaigns Targeting Attachments API
  version: 1.0.0
extends: openapi/mediamath-targeting-attachments-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['/attachments'].get
  update:
    x-apievangelist-phrasing:
      intent: List targeting attachments
      effect: read
      questions:
      - Which targeting attachments are on a given strategy?
      - Can I search and sort targeting attachments by target or restriction?
      instructions:
      - text: List targeting attachments for strategy {strategy_id}.
        slots:
          strategy_id: query.strategy_id
      - text: Show targeting attachments matching {q}.
        slots:
          q: query.q
      - text: List attachments in targeting dimension {dimension}.
        slots:
          dimension: query.dimension
      method: generated
      generated: '2026-10-01'
- target: $.paths['/attachments'].post
  update:
    x-apievangelist-phrasing:
      intent: Attach a target to a strategy
      effect: write
      questions:
      - How do I attach a targeting value to a strategy?
      - Can I set whether an attached target is included or excluded?
      instructions:
      - text: Attach target {target_id} to strategy {strategy_id} as {restriction} with operator {operator}.
        slots:
          target_id: requestBody.target_id
          strategy_id: requestBody.strategy_id
          restriction: requestBody.restriction
          operator: requestBody.operator
      - text: Exclude target {target_id} from strategy {strategy_id} using operator {operator} and restriction {restriction}.
        slots:
          target_id: requestBody.target_id
          strategy_id: requestBody.strategy_id
          restriction: requestBody.restriction
          operator: requestBody.operator
      method: generated
      generated: '2026-10-01'
- target: $.paths['/attachment'].get
  update:
    x-apievangelist-phrasing:
      intent: List attachments via the legacy endpoint
      effect: read
      questions:
      - Is there an older endpoint that still lists targeting attachments?
      - How do I list attachments using the legacy singular attachment path?
      instructions:
      - text: List targeting attachments using the legacy endpoint.
      - text: Get all attachments from the older /attachment listing.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/attachment'].post
  update:
    x-apievangelist-phrasing:
      intent: Attach a target via the legacy endpoint
      effect: write
      questions:
      - Can I still create a targeting attachment through the legacy endpoint?
      - How does creating an attachment work on the older singular path?
      instructions:
      - text: Using the legacy endpoint, attach target {target_id} to strategy {strategy_id} as {restriction} with {operator}.
        slots:
          target_id: requestBody.target_id
          strategy_id: requestBody.strategy_id
          restriction: requestBody.restriction
          operator: requestBody.operator
      - text: Create a legacy attachment linking target {target_id} and strategy {strategy_id}, restriction {restriction}, operator {operator}.
        slots:
          target_id: requestBody.target_id
          strategy_id: requestBody.strategy_id
          restriction: requestBody.restriction
          operator: requestBody.operator
      method: generated
      generated: '2026-10-01'
- target: $.paths['/attachments/{attachment_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a targeting attachment
      effect: read
      questions:
      - How do I look up one targeting attachment by its ID?
      - What target and strategy is a given attachment linked to?
      instructions:
      - text: Get targeting attachment {attachment_id}.
        slots:
          attachment_id: path.attachment_id
      - text: Show the details of attachment {attachment_id}.
        slots:
          attachment_id: path.attachment_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/attachments/{attachment_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a targeting attachment
      effect: write
      questions:
      - Can I change the restriction or operator on an existing attachment?
      - Why does updating an attachment require its version number?
      instructions:
      - text: Update attachment {attachment_id} at version {version} to restriction {restriction}.
        slots:
          attachment_id: path.attachment_id
          version: requestBody.version
          restriction: requestBody.restriction
      - text: Switch attachment {attachment_id} (version {version}) to operator {operator}.
        slots:
          attachment_id: path.attachment_id
          version: requestBody.version
          operator: requestBody.operator
      method: generated
      generated: '2026-10-01'
- target: $.paths['/attachments/{attachment_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a targeting attachment
      effect: destructive
      questions:
      - How do I remove a targeting attachment from a strategy?
      - Can I delete an attachment by its ID?
      instructions:
      - text: Delete targeting attachment {attachment_id}.
        slots:
          attachment_id: path.attachment_id
      - text: Remove attachment {attachment_id} from its strategy.
        slots:
          attachment_id: path.attachment_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/attachment/{attachment_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an attachment via the legacy endpoint
      effect: read
      questions:
      - Can I fetch a single attachment from the legacy singular path?
      - How do I read one attachment using the older endpoint?
      instructions:
      - text: Get attachment {attachment_id} from the legacy endpoint.
        slots:
          attachment_id: path.attachment_id
      - text: Look up attachment {attachment_id} using the older /attachment path.
        slots:
          attachment_id: path.attachment_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/attachment/{attachment_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an attachment via the legacy PUT
      effect: write
      questions:
      - Is there a legacy PUT endpoint for updating attachments?
      - How do I update an attachment through the older singular path?
      instructions:
      - text: Using the legacy PUT, update attachment {attachment_id} at version {version}.
        slots:
          attachment_id: path.attachment_id
          version: requestBody.version
      - text: Change legacy attachment {attachment_id} (version {version}) to target {target_id}.
        slots:
          attachment_id: path.attachment_id
          version: requestBody.version
          target_id: requestBody.target_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/attachment/{attachment_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an attachment via the legacy endpoint
      effect: destructive
      questions:
      - Can I delete an attachment through the legacy singular path?
      - How do I remove an attachment using the older endpoint?
      instructions:
      - text: Delete attachment {attachment_id} via the legacy endpoint.
        slots:
          attachment_id: path.attachment_id
      - text: Remove attachment {attachment_id} using the older /attachment path.
        slots:
          attachment_id: path.attachment_id
      method: generated
      generated: '2026-10-01'