API Evangelist conversational phrasing for Thehiveryiq Com Procurelock API

# 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 Procurelock API
  version: 1.0.0
extends: openapi/thehiveryiq-com-procurelock-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: 12
- target: $.paths['/v1/procurelock/mcp'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the ProcureLock MCP server
      effect: read
      questions:
      - What does the ProcureLock MCP server expose to agents?
      - Where can I read the metadata for the ProcureLock MCP endpoint?
      instructions:
      - text: Show the ProcureLock MCP server metadata.
      - text: Describe the ProcureLock MCP endpoint.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/procurelock/mcp'].post
  update:
    x-apievangelist-phrasing:
      intent: Call the ProcureLock MCP server
      effect: write
      questions:
      - How do I send an MCP request to ProcureLock?
      - Can my agent invoke ProcureLock tools over MCP?
      instructions:
      - text: Send this MCP request to the ProcureLock server.
      - text: Invoke a ProcureLock tool through its MCP endpoint.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/procurelock/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check ProcureLock health
      effect: read
      questions:
      - Is the ProcureLock purchase-order attestation service up?
      - Can I check whether ProcureLock is healthy before attesting a PO?
      instructions:
      - text: Check ProcureLock health.
      - text: Ping the ProcureLock service status.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/procurelock/pricing'].get
  update:
    x-apievangelist-phrasing:
      intent: Get ProcureLock pricing
      effect: read
      questions:
      - What does it cost to attest a purchase order or delivery with ProcureLock?
      - Is Cosmic tier priced differently in ProcureLock?
      instructions:
      - text: Show ProcureLock pricing.
      - text: List the prices for PO and delivery attestations.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/procurelock/po_attest'].post
  update:
    x-apievangelist-phrasing:
      intent: Attest a purchase order event
      effect: write
      questions:
      - How do I create a signed attestation for a purchase order?
      - Can the PO attestation receipt come back wrapped as an X12 or EDIFACT document?
      - Which ERP systems can I tag a purchase order attestation with?
      instructions:
      - text: Attest PO {po_number} from buyer {buyer_did} to supplier {supplier_did} for event {event_type} with hash {event_hash}.
        slots:
          po_number: requestBody.po_number
          buyer_did: requestBody.buyer_did
          supplier_did: requestBody.supplier_did
          event_type: requestBody.event_type
          event_hash: requestBody.event_hash
      - text: Attest PO {po_number} for {total_amount_cents} cents in {currency} under {incoterms} incoterms.
        slots:
          po_number: requestBody.po_number
          total_amount_cents: requestBody.total_amount_cents
          currency: requestBody.currency
          incoterms: requestBody.incoterms
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/procurelock/po_get/{attestation_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a purchase order attestation
      effect: read
      questions:
      - How do I retrieve a PO attestation record by its id?
      - What was stored in a purchase order attestation I created?
      instructions:
      - text: Get PO attestation {attestation_id}.
        slots:
          attestation_id: path.attestation_id
      - text: Show the purchase order attestation record {attestation_id}.
        slots:
          attestation_id: path.attestation_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/procurelock/po_verify/{attestation_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Verify a purchase order attestation
      effect: read
      questions:
      - Can I prove a purchase order attestation's signature is valid?
      - How do I check that a PO attestation hasn't been tampered with?
      instructions:
      - text: Verify PO attestation {attestation_id}.
        slots:
          attestation_id: path.attestation_id
      - text: Check the signature on attestation {attestation_id}.
        slots:
          attestation_id: path.attestation_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/procurelock/delivery_attest'].post
  update:
    x-apievangelist-phrasing:
      intent: Attest a delivery against a purchase order
      effect: write
      questions:
      - How do I record a goods-received attestation for a purchase order?
      - Can a delivery attestation capture inspection results and received quantities?
      instructions:
      - text: Attest delivery for PO {po_number} from {supplier_did} to {buyer_did} with status {delivery_status}.
        slots:
          po_number: requestBody.po_number
          supplier_did: requestBody.supplier_did
          buyer_did: requestBody.buyer_did
          delivery_status: requestBody.delivery_status
      - text: Record receipt of {received_qty} units on PO {po_number} under bill of lading {bol_number}.
        slots:
          received_qty: requestBody.received_qty
          po_number: requestBody.po_number
          bol_number: requestBody.bol_number
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/procurelock/match_verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a three-way match on a purchase order
      effect: read
      questions:
      - Does a purchase order pass three-way match between PO, goods receipt and invoice?
      - Can I accept a two-way match that skips the goods receipt?
      instructions:
      - text: Verify the match for PO {po_number}.
        slots:
          po_number: requestBody.po_number
      - text: Run a two-way match on PO {po_number} with {require_two_way}.
        slots:
          po_number: requestBody.po_number
          require_two_way: requestBody.require_two_way
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/procurelock/by-buyer/{buyer_did}'].get
  update:
    x-apievangelist-phrasing:
      intent: List attestations for a buyer
      effect: read
      questions:
      - Which PO attestations has a buying organization recorded?
      - Can I page through a buyer's procurement attestations?
      instructions:
      - text: List attestations for buyer {buyer_did}.
        slots:
          buyer_did: path.buyer_did
      - text: Show {limit} attestations for buyer {buyer_did} starting at {offset}.
        slots:
          limit: query.limit
          buyer_did: path.buyer_did
          offset: query.offset
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/procurelock/by-supplier/{supplier_did}'].get
  update:
    x-apievangelist-phrasing:
      intent: List attestations for a supplier
      effect: read
      questions:
      - Which attestations involve a particular supplier?
      - Can I page through every PO attestation for one supplier?
      instructions:
      - text: List attestations for supplier {supplier_did}.
        slots:
          supplier_did: path.supplier_did
      - text: Show {limit} attestations for supplier {supplier_did} from offset {offset}.
        slots:
          limit: query.limit
          supplier_did: path.supplier_did
          offset: query.offset
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/procurelock/by-po/{po_number}'].get
  update:
    x-apievangelist-phrasing:
      intent: List attestations for a PO number
      effect: read
      questions:
      - What attestations exist for a given purchase order number?
      - How do I see the full attestation history of one PO?
      instructions:
      - text: List attestations for PO number {po_number}.
        slots:
          po_number: path.po_number
      - text: Show the attestation trail for purchase order {po_number}.
        slots:
          po_number: path.po_number
      method: generated
      generated: '2026-09-26'