# 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 Prov API
  version: 1.0.0
extends: openapi/thehiveryiq-com-prov-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: 2
- target: $.paths['/v1/prov/pubkey'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the provenance signing public key
      effect: read
      questions:
      - What Ed25519 public key signs smash.prov provenance headers?
      - Where do I get the key to verify response provenance myself?
      instructions:
      - text: Fetch the provenance public key.
      - text: Show the Ed25519 key used for smash.prov.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/prov/verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify a response provenance signature
      effect: read
      questions:
      - How can I prove a response really came from this service?
      - Is verifying a smash.prov signature free and unauthenticated?
      instructions:
      - text: Verify signature {sig_b64u} for {method} {path} at timestamp {ts}.
        slots:
          sig_b64u: requestBody.sig_b64u
          method: requestBody.method
          path: requestBody.path
          ts: requestBody.ts
      - text: Check provenance of body {body_b64u} from {method} {path}, ts {ts}, sig {sig_b64u}.
        slots:
          body_b64u: requestBody.body_b64u
          method: requestBody.method
          path: requestBody.path
          ts: requestBody.ts
          sig_b64u: requestBody.sig_b64u
      method: generated
      generated: '2026-09-26'