# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Campaigns Contracts API
  version: 1.0.0
extends: openapi/mediamath-contracts-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: 5
- target: $.paths['/contracts'].get
  update:
    x-apievangelist-phrasing:
      intent: List contracts
      effect: read
      questions:
      - Which platform contracts are on file in MediaMath?
      - Can I search contracts by contract number?
      instructions:
      - text: List all contracts.
      - text: Search contracts matching {query}.
        slots:
          query: query.q
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contracts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a contract
      effect: write
      questions:
      - How do I set up a fee contract for an organization?
      - Can a new contract set platform access and managed service fees?
      instructions:
      - text: Create a contract for organization {org} starting {start}.
        slots:
          org: requestBody.organization_id
          start: requestBody.effective_start_date
      - text: Create a contract for organization {org} with a {fee} percent platform access fee.
        slots:
          org: requestBody.organization_id
          fee: requestBody.platform_access_fee_pct
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contracts/{contract_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a contract
      effect: read
      questions:
      - What fees and dates are on a specific contract?
      - Can I look up one contract by ID?
      instructions:
      - text: Get contract {contract}.
        slots:
          contract: path.contract_id
      - text: Show the fees and dates on contract {contract}.
        slots:
          contract: path.contract_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contracts/{contract_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a contract
      effect: write
      questions:
      - How do I change the end date on an existing contract?
      - Can I adjust the spend cap on a contract I already have?
      instructions:
      - text: Set contract {contract}'s end date to {end}.
        slots:
          contract: path.contract_id
          end: requestBody.effective_end_date
      - text: Change the spend cap on contract {contract} to {cap}.
        slots:
          contract: path.contract_id
          cap: requestBody.spend_cap
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contracts/{contract_id}/history'].get
  update:
    x-apievangelist-phrasing:
      intent: View a contract's change history
      effect: read
      questions:
      - Who changed this contract and when?
      - Where is the audit log for one contract?
      instructions:
      - text: Show the audit log for contract {contract}.
        slots:
          contract: path.contract_id
      - text: List the changes made to contract {contract}.
        slots:
          contract: path.contract_id
      method: generated
      generated: '2026-10-01'