# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Dynamicfeed Ai Agent API
  version: 1.0.0
extends: openapi/dynamicfeed-ai-agent-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: 61
- target: $.paths['/v1/discover'].get
  update:
    x-apievangelist-phrasing:
      intent: Find live data capabilities for a need
      effect: read
      questions:
      - Which Dynamic Feed tool should my agent use for live rainfall data in a given city?
      - Can I search capabilities in plain words and see measured uptime and latency for each match?
      - Does capability discovery also suggest external MCP servers from the official registry?
      instructions:
      - text: Discover capabilities that match the need {need}.
        slots:
          need: query.need
      - text: Find the top {limit} capabilities for {need} and leave out external MCP servers.
        slots:
          limit: query.limit
          need: query.need
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/discover'].post
  update:
    x-apievangelist-phrasing:
      intent: Discover capabilities with a JSON request body
      effect: read
      questions:
      - Is there a POST version of capability discovery that takes the need as a JSON body?
      - Can my agent send its capability-discovery request as JSON instead of query parameters?
      instructions:
      - text: Send a JSON body to the POST discover endpoint asking for sanctions screening capabilities.
      - text: Post a discovery request in JSON for satellite position tools including external servers.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/schemas/index.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List the receipt schema family
      effect: read
      questions:
      - What receipt schemas does Dynamic Feed publish, and which mint endpoint goes with each?
      - Are deprecated or quarantined receipt schemas still listed in the schema index?
      instructions:
      - text: Show me the DF-VERIFY/1 receipt schema index.
      - text: List every receipt schema profile with its $id and title.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/bundles'].get
  update:
    x-apievangelist-phrasing:
      intent: List curated tool bundles by domain
      effect: read
      questions:
      - What curated tool bundles exist so I can pick tools for my agent's use case?
      - Are there ready-made groupings of data tools per domain like finance or weather?
      instructions:
      - text: List all curated tool bundles.
      - text: Show me every domain bundle available for agents.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/bundles/{bundle_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one curated tool bundle
      effect: read
      questions:
      - Which tools are in the devsecops bundle?
      - Can I look up a single tool bundle by its id to see what it includes?
      instructions:
      - text: Show me the tools in bundle {bundle_id}.
        slots:
          bundle_id: path.bundle_id
      - text: Open the {bundle_id} bundle and list its tools.
        slots:
          bundle_id: path.bundle_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/batch'].post
  update:
    x-apievangelist-phrasing:
      intent: Run up to 20 data tool calls in one request
      effect: read
      questions:
      - Can I fetch weather and earthquakes together in a single free request?
      - How many tool calls can I bundle into one keyless batch request?
      - What happens if one call in a batch is slow or fails?
      instructions:
      - text: Run a free batch that gets current weather for London and recent earthquakes.
      - text: Get the list of tool names available for the keyless batch endpoint.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/pro/tool/{tool}'].get
  update:
    x-apievangelist-phrasing:
      intent: See the x402 price for a paid tool call
      effect: read
      questions:
      - What does a single paid call to a given tool cost, and what asset is it paid in?
      - Can I probe a pay-per-call tool without being charged to learn how to pay?
      instructions:
      - text: Show me the x402 payment challenge for the {tool} tool without paying.
        slots:
          tool: path.tool
      - text: Check the price of a paid single call to {tool}.
        slots:
          tool: path.tool
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/pro/tool/{tool}'].post
  update:
    x-apievangelist-phrasing:
      intent: Make a paid, signed single tool call
      effect: write
      questions:
      - Can my agent pay per call in USDC for one signed datapoint without signing up?
      - Is there a premium single-call endpoint that returns an Ed25519-signed result?
      instructions:
      - text: Pay for one signed call to the {tool} tool via x402.
        slots:
          tool: path.tool
      - text: Buy a single premium signed datapoint from {tool}.
        slots:
          tool: path.tool
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/pro/asof'].post
  update:
    x-apievangelist-phrasing:
      intent: Buy a signed historical replay of a tool value
      effect: write
      questions:
      - Can I pay per call to replay what a tool reported at a past time without an API key?
      - Is there a keyless paid way to get a signed archived observation from a specific moment?
      instructions:
      - text: Pay via x402 to replay archived current weather as of a specific past timestamp.
      - text: Buy a signed as-of replay from the archive without using an API key.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/pro/batch'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a paid batch of up to 100 signed calls
      effect: write
      questions:
      - Can my agent pay with a wallet to run more than 20 tool calls in one request?
      - What is the cap on signed tool calls in the paid batch tier?
      instructions:
      - text: Pay via x402 for a premium batch of up to 100 signed tool calls.
      - text: Run a paid signed batch of data tool calls from my agent's wallet.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/pro/catalog'].get
  update:
    x-apievangelist-phrasing:
      intent: List pay-per-call SKUs and prices
      effect: read
      questions:
      - What paid endpoints does Dynamic Feed sell and how much does each cost?
      - Which facilitator settles x402 payments, and which wallet receives them?
      instructions:
      - text: Show me the x402 price list for every paid endpoint.
      - text: List the pay-per-call SKUs with their input and output schemas.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/drift'].post
  update:
    x-apievangelist-phrasing:
      intent: Check AI-stated facts for drift from live data
      effect: read
      questions:
      - Can I check whether facts an LLM stated, like the latest Python version, are out of date?
      - Does drift detection grade each stale claim by severity and give a correction?
      instructions:
      - text: Audit the claims 'the latest Python is 3.11' and 'Node.js is on 18' for drift.
      - text: Check this LLM answer for facts that have drifted from current ground truth.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/guard'].post
  update:
    x-apievangelist-phrasing:
      intent: Guard a draft AI answer before sending it
      effect: read
      questions:
      - Can I screen my chatbot's draft answer for hallucinated facts before the user sees it?
      - What does the pre-answer guard return when a draft needs fixing?
      instructions:
      - text: Run the pre-answer guard on my AI's draft reply and tell me pass or revise.
      - text: Get the corrections needed for this draft answer before I send it.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/sources'].get
  update:
    x-apievangelist-phrasing:
      intent: List upstream data sources and licences
      effect: read
      questions:
      - Which upstream sources back Dynamic Feed's tools, and can I use them commercially?
      - What licence and update cadence does each data feed have?
      instructions:
      - text: List every upstream source with its publisher, licence and update cadence.
      - text: Show me which sources permit commercial use and redistribution.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/explain'].get
  update:
    x-apievangelist-phrasing:
      intent: Explain where a data point comes from
      effect: read
      questions:
      - Where does the earthquake data come from, and what is its chain of custody?
      - Can I trace a number back to its upstream source and licence with a simple GET?
      instructions:
      - text: Explain the source and custody trail for {subject} using the GET endpoint.
        slots:
          subject: query.subject
      - text: Trace where the {subject} data originates.
        slots:
          subject: query.subject
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/explain'].post
  update:
    x-apievangelist-phrasing:
      intent: Explain a data source via POST request
      effect: read
      questions:
      - Can I post a JSON subject to get its source provenance instead of using a query string?
      - Is there a POST form of the chain-of-custody explanation?
      instructions:
      - text: Post the subject {subject} to the explain endpoint for its provenance.
        slots:
          subject: query.subject
      - text: Use the POST explain call to show the licence and custody chain for {subject}.
        slots:
          subject: query.subject
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/snapshot'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the world-state snapshot for a day
      effect: read
      questions:
      - What did Dynamic Feed report about the world on a given date?
      - What happens if I request a snapshot from before the archive began?
      instructions:
      - text: Get the world snapshot stored for {date}.
        slots:
          date: query.date
      - text: Capture today's world-state snapshot.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/asof'].get
  update:
    x-apievangelist-phrasing:
      intent: Replay a tool's archived value at a past time
      effect: read
      questions:
      - What did the weather tool say at the exact moment I made a decision last week?
      - Does the as-of replay re-fetch data or return exactly what was served then?
      instructions:
      - text: Replay what {tool} reported as of {t}.
        slots:
          tool: query.tool
          t: query.t
      - text: Show the archived {tool} value nearest before {t}.
        slots:
          tool: query.tool
          t: query.t
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/watchlist'].get
  update:
    x-apievangelist-phrasing:
      intent: View my watchlist and current values
      effect: read
      questions:
      - Which subjects am I monitoring on my watchlist?
      - Can I pull current values for everything on my watchlist in one call?
      instructions:
      - text: Show my saved watchlist.
      - text: Show my watchlist with pull set to {pull} so each item's live value is included.
        slots:
          pull: query.pull
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/watchlist'].post
  update:
    x-apievangelist-phrasing:
      intent: Add to or replace my watchlist
      effect: write
      questions:
      - Can I add BTC to my watchlist so I can monitor it?
      - What is the maximum number of items a watchlist can hold?
      instructions:
      - text: Add BTC via the cite tool to my watchlist.
      - text: Replace my entire watchlist with a new set of items.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/watchlist'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an item or clear my watchlist
      effect: destructive
      questions:
      - Can I remove a single item from my watchlist by its label?
      - What happens if I delete from my watchlist without giving a label?
      instructions:
      - text: Remove {label} from my watchlist.
        slots:
          label: query.label
      - text: Clear my whole watchlist.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/stream'].get
  update:
    x-apievangelist-phrasing:
      intent: Stream a live tool value over SSE
      effect: read
      questions:
      - Can I subscribe to a live value with Server-Sent Events instead of polling?
      - What interval and update count limits apply to the live stream?
      instructions:
      - text: Stream {tool} with args {args} every {interval} seconds.
        slots:
          tool: query.tool
          args: query.args
          interval: query.interval
      - text: Open a live stream of {tool} and stop after {count} updates.
        slots:
          tool: query.tool
          count: query.count
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/webhooks'].get
  update:
    x-apievangelist-phrasing:
      intent: List my webhook subscriptions
      effect: read
      questions:
      - Which webhook subscriptions have I registered?
      - Are webhook secrets returned when I list my subscriptions?
      instructions:
      - text: List my webhook subscriptions.
      - text: Show all webhooks I have set up.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/webhooks'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a webhook for value changes
      effect: write
      questions:
      - Can I get a webhook call whenever the exploited vulnerabilities list changes?
      - How are webhook deliveries signed so I can verify they are genuine?
      instructions:
      - text: Register a webhook to my endpoint that fires when a tool's value changes.
      - text: Create a new webhook subscription for exploited vulnerability changes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/webhooks'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a webhook subscription
      effect: destructive
      questions:
      - Can I stop a webhook subscription I no longer need?
      - What do I need to pass to delete one of my webhooks?
      instructions:
      - text: Delete webhook subscription {id}.
        slots:
          id: query.id
      - text: Remove my webhook with id {id}.
        slots:
          id: query.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/webhooks/test'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a test webhook delivery
      effect: write
      questions:
      - Can I send a test delivery to check my endpoint validates the HMAC signature?
      - Is there a way to trigger a webhook now without waiting for a value to change?
      instructions:
      - text: Send a signed test delivery to my webhook subscription.
      - text: Fire a test event at one of my webhooks now.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1'].get
  update:
    x-apievangelist-phrasing:
      intent: Show the v1 agent and robot API overview
      effect: read
      questions:
      - What capabilities does the v1 agent and robot API offer at a glance?
      - Is there a single page listing every v1 endpoint with copy-paste examples?
      instructions:
      - text: Show me the v1 API index.
      - text: List every v1 capability with an example call.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/receipt'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a signed evidence receipt for data
      effect: write
      questions:
      - Can I get timestamped, signed proof of what my AI was told?
      - Which key do I verify an evidence receipt's signature against?
      instructions:
      - text: Wrap this claim in a signed evidence receipt.
      - text: Create an Ed25519-signed receipt for this JSON data.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/stamp'].post
  update:
    x-apievangelist-phrasing:
      intent: Stamp submitted JSON as a verifiable record
      effect: write
      questions:
      - Can I create an independently verifiable record of some JSON without an API key?
      - Does a stamp signature prove the JSON content is true or only its integrity?
      instructions:
      - text: Stamp this JSON document as a verifiable record.
      - text: Create an integrity stamp for my submitted JSON.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/agent/receipt'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a signed receipt of an agent action
      effect: write
      questions:
      - Can I prove after the fact what inputs my AI agent acted on and what it decided?
      - What fields go into an agent receipt besides the inputs?
      instructions:
      - text: Create an agent receipt for my agent's last action and its inputs.
      - text: Record a signed receipt of the decision my agent made.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/notarize'].post
  update:
    x-apievangelist-phrasing:
      intent: Notarize data or its hash
      effect: write
      questions:
      - Can a neutral third party notarize my data feed so I can prove it existed at a moment?
      - Can I notarize only a SHA-256 hash and keep the data private?
      instructions:
      - text: Notarize this JSON payload.
      - text: Notarize my data by sending only its SHA-256 hash.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/exposure-report'].get
  update:
    x-apievangelist-phrasing:
      intent: Generate a signed decision exposure report
      effect: read
      questions:
      - Where do my organisation's decisions rely on external data we cannot verify?
      - Can I get a signed exposure report for specific perils at a location?
      instructions:
      - text: Build an exposure report for {organisation} covering {perils} at {place}.
        slots:
          organisation: query.organisation
          perils: query.perils
          place: query.place
      - text: Generate an exposure report for the {use_case} use case at {lat}, {lon}.
        slots:
          use_case: query.use_case
          lat: query.lat
          lon: query.lon
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/evidence/wildfire'].get
  update:
    x-apievangelist-phrasing:
      intent: Build a signed evidence record for a wildfire
      effect: read
      questions:
      - Can I wrap a wildfire detection with independent fire-weather and smoke context?
      - What context is captured in a wildfire chain-of-custody evidence record?
      instructions:
      - text: Create a wildfire evidence record for a detection at {lat}, {lon}.
        slots:
          lat: query.lat
          lon: query.lon
      - text: Build wildfire evidence at {lat}, {lon} detected by {detector} at {detected_at}.
        slots:
          lat: query.lat
          lon: query.lon
          detector: query.detector
          detected_at: query.detected_at
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/vc'].post
  update:
    x-apievangelist-phrasing:
      intent: Call the quarantined legacy VC wrapping
      effect: write
      questions:
      - Is the legacy verifiable-credential wrapping endpoint still safe to use?
      - Why was the VC wrapping endpoint put in security quarantine?
      instructions:
      - text: Call the quarantined legacy VC wrapping endpoint.
      - text: Submit a receipt to the legacy verifiable credential wrapper.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/station/register'].post
  update:
    x-apievangelist-phrasing:
      intent: Register my own sensor station
      effect: write
      questions:
      - Can I register my own weather sensor so its readings are witnessed as signed receipts?
      - Does registering a station mean Dynamic Feed measures the values itself?
      instructions:
      - text: Register my sensor station with its name, location and quantities.
      - text: Sign up a new station that reports wind speed.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/station/reading'].post
  update:
    x-apievangelist-phrasing:
      intent: Witness a reading from my station
      effect: write
      questions:
      - Can I get a signed receipt for a value my registered station reported?
      - Is a station reading receipt marked as self-reported rather than measured?
      instructions:
      - text: Witness a wind reading from my registered station.
      - text: Submit my station's latest reading for a signed receipt.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/station/{station_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a registered station
      effect: read
      questions:
      - What does a registered station report, without revealing who owns it?
      - Can a verifier look up the station behind a station receipt?
      instructions:
      - text: Show the public descriptor for station {station_id}.
        slots:
          station_id: path.station_id
      - text: Look up what station {station_id} reports.
        slots:
          station_id: path.station_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/proxy-witness'].post
  update:
    x-apievangelist-phrasing:
      intent: Witness a third-party API response
      effect: write
      questions:
      - Can I route a third-party API call through a witness and get a signed record of its response?
      - Are private network addresses blocked when proxying a call for witnessing?
      instructions:
      - text: Fetch this third-party URL through the proxy witness and sign what it returned.
      - text: Get a signed archived receipt of what an external API responded right now.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/witness'].post
  update:
    x-apievangelist-phrasing:
      intent: Witness an agent-to-agent transaction record
      effect: write
      questions:
      - Can a neutral party sign and timestamp a machine-to-machine transaction record?
      - Does the transaction witness ever hold or move funds?
      instructions:
      - text: Witness this agent-to-agent transaction record.
      - text: Get a signed, logged receipt that this transaction record exists and is intact.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/witness/sample'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a sample transaction witness receipt
      effect: read
      questions:
      - What does a transaction witness receipt look like before I integrate?
      - Is there a demo txn-receipt I can verify in the browser?
      instructions:
      - text: Show me a sample transaction witness receipt.
      - text: Get the demo txn-receipt/v1 to test verification.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/inference-receipt'].post
  update:
    x-apievangelist-phrasing:
      intent: Witness an AI model inference
      effect: write
      questions:
      - Can I prove which model served an inference without sending the prompt or response?
      - What hashes and metadata go into an inference receipt?
      instructions:
      - text: Create an inference receipt from my prompt and response hashes.
      - text: Witness this AI inference using only its SHA-256 hashes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/inference-receipt/sample'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a sample inference receipt
      effect: read
      questions:
      - What does an inference receipt look like when a provider served a different model?
      - Is there a sample inference receipt I can verify in my browser?
      instructions:
      - text: Show me a sample inference receipt.
      - text: Get the demo inference-receipt/v1.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/eval-receipt'].post
  update:
    x-apievangelist-phrasing:
      intent: Witness an AI evaluation run
      effect: write
      questions:
      - Can I get a signed Verified Eval stamp while keeping my test set private?
      - How does committing a salted hash of my test set prevent retuning after the run?
      instructions:
      - text: Create an eval receipt for my benchmark run with its set commitment.
      - text: Witness this AI evaluation run as a Verified Eval.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/eval-receipt/sample'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a sample evaluation receipt
      effect: read
      questions:
      - What does a Verified Eval receipt look like?
      - Is there a demo eval receipt I can check before submitting my own run?
      instructions:
      - text: Show me a sample eval receipt.
      - text: Get the demo eval-receipt/v1 for verification testing.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/checkpoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List daily archive checkpoints
      effect: read
      questions:
      - Can I verify the archive is append-only by checking its daily digests?
      - What is the anchor status of recent archive checkpoints?
      instructions:
      - text: List recent daily archive checkpoints.
      - text: Show the latest {limit} archive checkpoints.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/checkpoints/{day}/proof'].get
  update:
    x-apievangelist-phrasing:
      intent: Download the timestamp proof for a day
      effect: read
      questions:
      - Can I download the RFC 3161 token for a given day's archive checkpoint?
      - Which proof formats are available for an archive checkpoint?
      instructions:
      - text: Download the checkpoint proof for {day}.
        slots:
          day: path.day
      - text: Get the {kind} proof for the {day} archive checkpoint.
        slots:
          kind: query.kind
          day: path.day
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/notary/log/head'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the notary transparency log head
      effect: read
      questions:
      - What is the current head hash and entry count of the notary log?
      - Which signed artifact should I anchor to detect tampering with past notarizations?
      instructions:
      - text: Show the current notary log head.
      - text: Get the signed chain head hash of the transparency log.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/notary/log/{idx}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one notary log entry
      effect: read
      questions:
      - Can I fetch a single notarization log entry by its index?
      - How do I recompute an entry hash to verify chain linkage?
      instructions:
      - text: Show notary log entry {idx}.
        slots:
          idx: path.idx
      - text: Fetch transparency log entry number {idx}.
        slots:
          idx: path.idx
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/notary/log'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse the public notarization log
      effect: read
      questions:
      - Can I browse all notarizations in the public transparency log?
      - Does the transparency log contain payloads or only their hashes?
      instructions:
      - text: List the newest notarizations in the transparency log.
      - text: Page the notary log back from entry {before}, {limit} at a time.
        slots:
          before: query.before
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/notary/log/{idx}/proof'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an inclusion proof for a notarization
      effect: read
      questions:
      - Can I prove a notarization is part of the anchored history without trusting Dynamic Feed?
      - What does a notary log inclusion proof chain back to?
      instructions:
      - text: Get the inclusion proof for notary entry {idx}.
        slots:
          idx: path.idx
      - text: Prove that log entry {idx} is in the anchored history.
        slots:
          idx: path.idx
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/witness/{idx}/inclusion'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Merkle inclusion proof for a witness
      effect: read
      questions:
      - Is there a compact Merkle audit path I can verify in my browser for a witness entry?
      - Can I check a witness entry's inclusion with only the published key?
      instructions:
      - text: Get the Merkle inclusion path for witness entry {idx}.
        slots:
          idx: path.idx
      - text: Show the signed-checkpoint audit path for witness {idx}.
        slots:
          idx: path.idx
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/notary/feeds'].get
  update:
    x-apievangelist-phrasing:
      intent: List my continuous notarization feeds
      effect: read
      questions:
      - Which feeds have I registered for continuous notarization?
      - When will my notarized feeds next be fetched?
      instructions:
      - text: List my registered notarization feeds.
      - text: Show the status and last hash of each feed I notarize.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/notary/feeds'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a feed for continuous notarization
      effect: write
      questions:
      - Can I have my feed URL fetched on a schedule and every change notarized automatically?
      - What is the minimum interval and how many active feeds can one key register?
      instructions:
      - text: Register my feed URL for continuous notarization every 180 minutes.
      - text: Start notarizing every change to my company's published feed.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/benchmark'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the live-facts benchmark
      effect: read
      questions:
      - Is there a benchmark of facts that change after a model's training cutoff?
      - Can I grade a model without tools against answers measured from live sources?
      instructions:
      - text: Get the current live-facts benchmark items.
      - text: Show me the signed live-facts eval set with grading rules.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/benchmark/history'].get
  update:
    x-apievangelist-phrasing:
      intent: Get live-facts benchmark history
      effect: read
      questions:
      - How fast do live-fact benchmark answers drift day over day?
      - Can I diff past daily snapshots of the live-facts benchmark?
      instructions:
      - text: Show live-facts benchmark snapshots for the last {days} days.
        slots:
          days: query.days
      - text: Get the full daily history of the live-facts benchmark.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/nearby'].get
  update:
    x-apievangelist-phrasing:
      intent: Scan for live hazards near a point
      effect: read
      questions:
      - What earthquakes, wildfires or disasters are happening near my drone's location?
      - Can I limit a hazard scan to a radius in kilometres?
      instructions:
      - text: Scan for hazards near {lat}, {lon}.
        slots:
          lat: query.lat
          lon: query.lon
      - text: List live hazards within {radius_km} km of {lat}, {lon}.
        slots:
          radius_km: query.radius_km
          lat: query.lat
          lon: query.lon
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/attest'].get
  update:
    x-apievangelist-phrasing:
      intent: Attest whether a weather threshold is met
      effect: read
      questions:
      - Can I get a signed MET or NOT-MET record for wind speed above a threshold at a place?
      - Which metrics and comparison operators does the parametric attestation support?
      instructions:
      - text: Attest whether {metric} is {op} {threshold} in {city}.
        slots:
          metric: query.metric
          op: query.op
          threshold: query.threshold
          city: query.city
      - text: Check if {metric} exceeds {threshold} at {lat}, {lon} and sign the result.
        slots:
          metric: query.metric
          threshold: query.threshold
          lat: query.lat
          lon: query.lon
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/trigger-receipt'].get
  update:
    x-apievangelist-phrasing:
      intent: Issue a parametric catastrophe trigger receipt
      effect: read
      questions:
      - Can I get a dispute-proof receipt that a parametric insurance trigger fired?
      - Does a trigger receipt pin the methodology so it cannot change after the event?
      instructions:
      - text: Issue a trigger receipt for {metric} {op} {threshold} at {city} under contract {contract_ref}.
        slots:
          metric: query.metric
          op: query.op
          threshold: query.threshold
          city: query.city
          contract_ref: query.contract_ref
      - text: Create a {peril} trigger receipt for {metric} above {threshold} at {lat}, {lon}.
        slots:
          peril: query.peril
          metric: query.metric
          threshold: query.threshold
          lat: query.lat
          lon: query.lon
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/intensity'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the signed flood intensity at a coordinate
      effect: read
      questions:
      - What is the river gauge reading at an exact coordinate for a flood trigger?
      - Which official gauge is used for the intensity at my location?
      instructions:
      - text: Get the flood intensity at {lat}, {lon}.
        slots:
          lat: query.lat
          lon: query.lon
      - text: Read {metric} for peril {peril} at {lat}, {lon}.
        slots:
          metric: query.metric
          peril: query.peril
          lat: query.lat
          lon: query.lon
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/bushfire'].get
  update:
    x-apievangelist-phrasing:
      intent: List Australian bushfire hotspots
      effect: read
      questions:
      - Are there satellite bushfire hotspots near me in Australia?
      - Can I see recent fire hotspots for a single Australian state?
      instructions:
      - text: Show bushfire hotspots in {state}.
        slots:
          state: query.state
      - text: List bushfire hotspots within {radius_km} km of {lat}, {lon}.
        slots:
          radius_km: query.radius_km
          lat: query.lat
          lon: query.lon
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/me'].get
  update:
    x-apievangelist-phrasing:
      intent: Check my API key plan and usage
      effect: read
      questions:
      - How many calls have I used today and how many remain on my key?
      - Which plan is my API key on?
      instructions:
      - text: Show my API key usage and remaining quota.
      - text: Check my plan and today's call count.
      method: generated
      generated: '2026-10-01'