# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Thehiveryiq Com Insurance API
  version: 1.0.0
extends: openapi/thehiveryiq-com-insurance-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/v1/law/insurance/template/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List insurance arbitration templates
      effect: read
      questions:
      - What insurance arbitration templates are available in HiveLaw?
      - Can I pass metadata to narrow the arbitration template list?
      instructions:
      - text: List the insurance arbitration templates.
      - text: List insurance arbitration templates with metadata {metadata}.
        slots:
          metadata: requestBody.metadata
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/law/insurance/agents'].get
  update:
    x-apievangelist-phrasing:
      intent: List insurance arbitration agents
      effect: read
      questions:
      - Which agents take part in insurance dispute arbitration?
      - Who are the insurance arbitration agents available?
      instructions:
      - text: List the insurance arbitration agents.
      - text: Show the agents that handle insurance disputes.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/law/insurance/template'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the insurance contract template
      effect: read
      questions:
      - What fields does an insurance contract template require?
      - Where can I see the default insurance contract template?
      instructions:
      - text: Get the insurance contract template.
      - text: Show me the default insurance template shape.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/law/insurance/contract'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an insurance claim contract
      effect: write
      questions:
      - How do I set up an insurance contract with policy, claim and insurer bond details?
      - Can I add a reinsurer or repair vendor to an insurance contract?
      - What coverage limit and deductible fields does a contract take?
      instructions:
      - text: 'Create a {lob} contract for policy {policy}: insured {insured}, insurer {insurer}, adjuster {adjuster}, in {country} {region}.'
        slots:
          lob: requestBody.line_of_business
          policy: requestBody.policy_id
          insured: requestBody.insured_did
          insurer: requestBody.insurer_did
          adjuster: requestBody.claims_adjuster_agent_did
          country: requestBody.country_iso
          region: requestBody.region
      - text: Open {claim_type} claim {claim} from {date} for {amount} USDC, limit {limit}, deductible {deductible}, bond {bond}.
        slots:
          claim_type: requestBody.claim_type
          claim: requestBody.claim_id
          date: requestBody.incident_date
          amount: requestBody.claimed_amount_usdc
          limit: requestBody.coverage_limit_usdc
          deductible: requestBody.deductible_usdc
          bond: requestBody.insurer_bond_usdc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/law/insurance/contract/{contract_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an insurance contract's details
      effect: read
      questions:
      - What are the terms and claim details of an insurance contract I created?
      - Can I look up an insurance contract by its id?
      instructions:
      - text: Get insurance contract {contract_id}.
        slots:
          contract_id: path.contract_id
      - text: Show the details of insurance contract {contract_id}.
        slots:
          contract_id: path.contract_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/law/insurance/dispute'].post
  update:
    x-apievangelist-phrasing:
      intent: File an insurance claim dispute
      effect: write
      questions:
      - How do I dispute an adjuster's denial or lowball offer on a claim?
      - Can I attach evidence when filing an insurance dispute?
      instructions:
      - text: File a dispute on insurance contract {contract_id} as {filer_did}.
        slots:
          contract_id: requestBody.contract_id
          filer_did: requestBody.filer_did
      - text: 'Dispute contract {contract_id} as {filer_did}: adjuster offered {adjuster_proposed_usdc} USDC, evidence {evidence}.'
        slots:
          contract_id: requestBody.contract_id
          filer_did: requestBody.filer_did
          adjuster_proposed_usdc: requestBody.adjuster_proposed_usdc
          evidence: requestBody.evidence
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/law/insurance/webhook'].post
  update:
    x-apievangelist-phrasing:
      intent: Send an insurance exception event via webhook
      effect: write
      questions:
      - Can an MGA push insurance exception events and have them resolved as disputes automatically?
      - What payload shape does the insurance exception webhook accept?
      instructions:
      - text: Send this insurance exception event to the HiveLaw webhook.
      - text: Post a carrier exception event so it is filed and resolved as a dispute.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/law/insurance/dispute/{dispute_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an insurance dispute's outcome
      effect: read
      questions:
      - How was my insurance dispute resolved?
      - Can I check the status of a dispute by its id?
      instructions:
      - text: Get insurance dispute {dispute_id}.
        slots:
          dispute_id: path.dispute_id
      - text: Show the resolution of dispute {dispute_id}.
        slots:
          dispute_id: path.dispute_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/law/insurance/economics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get insurance arbitration economics
      effect: read
      questions:
      - What fees and economics apply to insurance arbitration?
      - How much does HiveLaw insurance dispute resolution cost?
      instructions:
      - text: Show the insurance arbitration economics.
      - text: Get fee details for insurance disputes.
      method: generated
      generated: '2026-09-26'