API Evangelist conversational phrasing for Mandateshield Com Public proof network API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Mandateshield Com Public proof network API
  version: 1.0.0
extends: openapi/mandateshield-com-public-proof-network-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: 5
- target: $.paths['/api/v1/proof-network/challenges'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a subject-binding proof challenge
      effect: write
      questions:
      - How do I get a DNS TXT or GitHub commit challenge to bind my conformance self-report to my domain?
      - Does MandateShield run my implementation when I submit a conformance report?
      - How long is a proof network binding challenge valid?
      instructions:
      - text: Create a proof network binding challenge for subject {subject} with conformance report {report}.
        slots:
          subject: requestBody.subject
          report: requestBody.report
      - text: Start a self-report binding for my domain {subject} using report {report}.
        slots:
          subject: requestBody.subject
          report: requestBody.report
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/proof-network/attestations'].post
  update:
    x-apievangelist-phrasing:
      intent: Bind and sign a self-report attestation
      effect: write
      questions:
      - Once my DNS TXT record or GitHub binding is in place, how do I get the signed self-report attestation?
      - What terms do I have to accept before a proof attestation is published?
      - When is a repository commit required for issuing an attestation?
      instructions:
      - text: Issue the attestation for challenge {challenge_token}, accepting publisher terms {publisher_terms_accepted}.
        slots:
          challenge_token: requestBody.challenge_token
          publisher_terms_accepted: requestBody.publisher_terms_accepted
      - text: Bind challenge {challenge_token} to GitHub commit {repository_commit} with publisher terms accepted {publisher_terms_accepted}.
        slots:
          challenge_token: requestBody.challenge_token
          repository_commit: requestBody.repository_commit
          publisher_terms_accepted: requestBody.publisher_terms_accepted
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/proof-network/proofs'].get
  update:
    x-apievangelist-phrasing:
      intent: List published self-report proofs
      effect: read
      questions:
      - Which externally bound self-report proofs have been published?
      - Are sandbox runs or telemetry included in the public proof list?
      instructions:
      - text: List the published proof network self-reports.
      - text: Show {limit} externally bound self-report summaries.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/proof-network/proofs/{proofId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one signed self-report proof
      effect: read
      questions:
      - Can I see the full claimant report and subject binding behind a published proof?
      - What caveats come with a single externally bound self-report?
      instructions:
      - text: Get the full signed self-report for proof {proofId}.
        slots:
          proofId: path.proofId
      - text: Show the subject binding and claimant report of proof network entry {proofId}.
        slots:
          proofId: path.proofId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/proof-network/proofs/{proofId}/badge.svg'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a self-report proof badge
      effect: read
      questions:
      - How do I embed an externally bound self-report badge on my site?
      - Is the self-report badge a certification or audit mark?
      instructions:
      - text: Fetch the self-report SVG badge for proof {proofId}.
        slots:
          proofId: path.proofId
      - text: Get the externally bound self-report badge image for {proofId}.
        slots:
          proofId: path.proofId
      method: generated
      generated: '2026-09-26'