# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for BYOA Custom Bid Router API
  version: 1.0.0
extends: openapi/mediamath-custom-bid-router-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: 3
- target: $.paths['/custombidrouter/{org_id}/configuration'].get
  update:
    x-apievangelist-phrasing:
      intent: Get custom bid router configuration summary
      effect: read
      questions:
      - Have I configured custom bid router endpoints for every region?
      - Which executors, environments and endpoints does my organization have?
      instructions:
      - text: Get the custom bid router configuration summary for organization {org_id}.
        slots:
          org_id: path.org_id
      - text: Show all executors and endpoints set up for org {org_id}.
        slots:
          org_id: path.org_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/custombidrouter/{org_id}/executors/{executor_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom bid router executor
      effect: read
      questions:
      - What endpoints are attached to a specific bid router executor?
      - Can I see one executor's current sample rate?
      instructions:
      - text: Get executor {executor_id} for organization {org_id}.
        slots:
          org_id: path.org_id
          executor_id: path.executor_id
      - text: Show endpoints attached to executor {executor_id} in org {org_id}.
        slots:
          org_id: path.org_id
          executor_id: path.executor_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/custombidrouter/{org_id}/executors/{executor_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change an executor's sample rate
      effect: write
      questions:
      - How do I control what share of bid opportunities reach my endpoints?
      - Can I lower the sample rate to limit system load?
      instructions:
      - text: Set the sample rate of executor {executor_id} in org {org_id} to {sample_rate}.
        slots:
          executor_id: path.executor_id
          org_id: path.org_id
          sample_rate: requestBody.sample_rate
      - text: Forward {sample_rate} of bid opportunities through executor {executor_id} for org {org_id}.
        slots:
          sample_rate: requestBody.sample_rate
          executor_id: path.executor_id
          org_id: path.org_id
      method: generated
      generated: '2026-10-01'