# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Raw Data Pull API V2 Token Protect360 fraud API
  version: 1.0.0
extends: openapi/appsflyer-protect360-fraud-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: 6
- target: $.paths['/{app-id}/blocked_clicks_report/v5'].get
  update:
    x-apievangelist-phrasing:
      intent: Pull clicks blocked by Protect360
      effect: read
      questions:
      - Which clicks did Protect360 block as fraud?
      - Can I see blocked clicks for a single media source?
      instructions:
      - text: Pull blocked clicks for {app} from {from} to {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
      - text: Get Protect360 blocked clicks from {media_source} on {app} between {from} and {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
          media_source: query.media_source
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{app-id}/blocked_in_app_events_report/v5'].get
  update:
    x-apievangelist-phrasing:
      intent: Pull in-app events blocked as fraud
      effect: read
      questions:
      - Which in-app events were flagged fraudulent and blocked?
      - Can I filter blocked events to purchases only?
      instructions:
      - text: Pull blocked in-app events for {app} from {from} to {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
      - text: Get blocked fraudulent event {event_name} on {app} between {from} and {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
          event_name: query.event_name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{app-id}/blocked_install_postbacks/v5'].get
  update:
    x-apievangelist-phrasing:
      intent: Pull postbacks for blocked installs
      effect: read
      questions:
      - What postbacks were sent to networks about installs we blocked?
      - Can I see copies of blocked-install postbacks in real time?
      instructions:
      - text: Pull blocked install postbacks for {app} from {from} to {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
      - text: Get the blocked-install postbacks sent to {media_source} for {app} between {from} and {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
          media_source: query.media_source
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{app-id}/blocked_installs_report/v5'].get
  update:
    x-apievangelist-phrasing:
      intent: Pull installs blocked as fraud
      effect: read
      questions:
      - How many installs were blocked as fraud and left unattributed?
      - Can I check blocked installs per country?
      instructions:
      - text: Pull the blocked installs report for {app} from {from} to {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
      - text: Get fraud-blocked installs for {app} in {geo} between {from} and {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
          geo: query.geo
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{app-id}/detection/v5'].get
  update:
    x-apievangelist-phrasing:
      intent: Pull post-attribution fraud installs
      effect: read
      questions:
      - Which installs were attributed first and later found to be fraudulent?
      - Can I see post-attribution fraud for one agency?
      instructions:
      - text: Pull post-attribution fraudulent installs for {app} from {from} to {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
      - text: Get installs reclassified as fraud after attribution for agency {agency} on {app} between {from} and {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
          agency: query.agency
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{app-id}/fraud-post-inapps/v5'].get
  update:
    x-apievangelist-phrasing:
      intent: Pull post-attribution fraud in-app events
      effect: read
      questions:
      - Which in-app events belong to installs judged fraudulent after attribution?
      - Can I see fraudulent events even when the install itself was fine?
      instructions:
      - text: Pull post-attribution fraudulent in-app events for {app} from {from} to {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
      - text: Get post-attribution fraud event {event_name} for {app} between {from} and {to}.
        slots:
          app: path.app-id
          from: query.from
          to: query.to
          event_name: query.event_name
      method: generated
      generated: '2026-10-01'