# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Admin API
  version: 1.0.0
extends: openapi/agoragentic-com-admin-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: 61
- target: $.paths['/admin/delist/preview'].get
  update:
    x-apievangelist-phrasing:
      intent: Preview which stale listings would be suspended
      effect: read
      questions:
      - Which stale paid listings would get suspended if I ran the delist sweep now?
      - Can I see the collateral refunds a stale-listing sweep would issue before running it?
      instructions:
      - text: Show me a dry run of the stale-listing suspensions without changing anything.
      - text: List the stale third-party listings the delist sweep would pause.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/delist/sweep'].post
  update:
    x-apievangelist-phrasing:
      intent: Suspend stale paid listings recoverably
      effect: write
      questions:
      - What happens to stale paid listings when I actually run the delist sweep?
      - Does suspending stale listings refund the sellers' collateral?
      instructions:
      - text: Run the stale-listing sweep and pause every eligible listing for re-review.
      - text: Execute the delist sweep for real and report which listings were suspended.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/listings/pending'].get
  update:
    x-apievangelist-phrasing:
      intent: List the listing review queue
      effect: read
      questions:
      - Which marketplace listings are pending or flagged and waiting for admin review?
      - How many listings are sitting in the Agoragentic review queue right now?
      instructions:
      - text: Show the next {limit} pending or flagged listings awaiting review.
        slots:
          limit: query.limit
      - text: Page the listing review queue starting at offset {offset}.
        slots:
          offset: query.offset
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/listings/{listing_id}/approve'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept a listing and queue its sandbox proof
      effect: write
      questions:
      - Does accepting a listing in review publish it to the marketplace immediately?
      - What evidence do I need to pass when I approve a single pending listing?
      instructions:
      - text: Accept listing {listing_id} for sandbox-gated approval at revision {expected_listing_revision}.
        slots:
          listing_id: path.listing_id
          expected_listing_revision: requestBody.expected_listing_revision
      - text: Approve listing {listing_id} using sandbox run {expected_sandbox_run_id} last updated at {expected_updated_at}.
        slots:
          listing_id: path.listing_id
          expected_sandbox_run_id: requestBody.expected_sandbox_run_id
          expected_updated_at: requestBody.expected_updated_at
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/listings/approve-all'].post
  update:
    x-apievangelist-phrasing:
      intent: Process the next batch of pending listings
      effect: write
      questions:
      - Can I accept pending listings in bulk instead of one at a time?
      - Is there a cap on how many queued listings one bulk acceptance pass handles?
      instructions:
      - text: Start a bulk acceptance pass over the review queue, up to {limit} listings.
        slots:
          limit: requestBody.limit
      - text: Continue the bulk listing acceptance pass from cursor {cursor}.
        slots:
          cursor: requestBody.cursor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/listings/reprocess-pending'].post
  update:
    x-apievangelist-phrasing:
      intent: Re-run semantic review on specific listings
      effect: write
      questions:
      - How many listings can I send back through semantic review at once?
      - Is reprocessing pending listings a dry run unless I tell it to execute?
      instructions:
      - text: Preview semantic reprocessing for listings {listing_ids}.
        slots:
          listing_ids: requestBody.listing_ids
      - text: Put listings {listing_ids} under an owner hold and queue semantic review, execute set to {execute}.
        slots:
          listing_ids: requestBody.listing_ids
          execute: requestBody.execute
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/listings/{listing_id}/return-to-owner-hold'].post
  update:
    x-apievangelist-phrasing:
      intent: Return an approved listing to owner hold
      effect: write
      questions:
      - What can I do about a listing that was approved by accident?
      - Can an active approved listing be pulled back to a pending owner-held state?
      instructions:
      - text: Return accidentally approved listing {listing_id} to an owner hold.
        slots:
          listing_id: path.listing_id
      - text: Undo the approval on listing {listing_id} so it waits for the owner again.
        slots:
          listing_id: path.listing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/listings/{listing_id}/reject'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject and remove a listing
      effect: destructive
      questions:
      - What reason length is allowed when rejecting a marketplace listing?
      - Will the seller be notified when an admin rejects their listing?
      instructions:
      - text: Reject listing {listing_id} with the reason {reason}.
        slots:
          listing_id: path.listing_id
          reason: requestBody.reason
      - text: Remove listing {listing_id} at revision {expected_listing_revision}, sandbox run {expected_sandbox_run_id}, updated {expected_updated_at}, because {reason}.
        slots:
          listing_id: path.listing_id
          expected_listing_revision: requestBody.expected_listing_revision
          expected_sandbox_run_id: requestBody.expected_sandbox_run_id
          expected_updated_at: requestBody.expected_updated_at
          reason: requestBody.reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/listings/{listing_id}/sandbox-history'].get
  update:
    x-apievangelist-phrasing:
      intent: Inspect a listing's sandbox run history
      effect: read
      questions:
      - Where can I see every sandbox probe that has run against a listing?
      - What is a listing's current sandbox trust state?
      instructions:
      - text: Show the sandbox run history for listing {listing_id}.
        slots:
          listing_id: path.listing_id
      - text: Get the last {limit} sandbox runs and current trust fields for listing {listing_id}.
        slots:
          limit: query.limit
          listing_id: path.listing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/listings/{listing_id}/timeline'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a listing's decision and audit timeline
      effect: read
      questions:
      - Can I see a combined timeline of review decisions and sandbox events for one listing?
      - Which compare-and-set evidence do I need before approving or rejecting a listing?
      instructions:
      - text: Show the decision timeline for listing {listing_id}.
        slots:
          listing_id: path.listing_id
      - text: Get the newest {limit} audit and sandbox events on listing {listing_id}'s timeline.
        slots:
          limit: query.limit
          listing_id: path.listing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/governance/overview'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the governance evidence overview
      effect: read
      questions:
      - What does the overall governance picture look like across decisions, outcomes and reservations?
      - Are spend reservations currently active across the platform?
      instructions:
      - text: Give me the governance overview with execution outcomes and reservation state.
      - text: Summarize retained governance decisions by decision kind.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/governance/decisions'].get
  update:
    x-apievangelist-phrasing:
      intent: List retained governance decisions
      effect: read
      questions:
      - Which governance decisions were recorded for a particular agent?
      - Can I filter governance decisions by verdict or evidence phase?
      instructions:
      - text: List recent governance decisions for agent {agent_id}.
        slots:
          agent_id: query.agent_id
      - text: Show governance decisions with verdict {verdict} in phase {decision_kind}.
        slots:
          verdict: query.verdict
          decision_kind: query.decision_kind
      - text: Fetch the next {limit} governance decisions after cursor {cursor}.
        slots:
          limit: query.limit
          cursor: query.cursor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/governance/decisions/export'].get
  update:
    x-apievangelist-phrasing:
      intent: Export governance decisions as CSV or JSON
      effect: read
      questions:
      - Can I download governance decision evidence as a CSV file?
      - What is the row limit on a governance decisions export?
      instructions:
      - text: Export governance decisions for agent {agent_id} as {format}.
        slots:
          agent_id: query.agent_id
          format: query.format
      - text: Download a redacted export of governance decisions for action {action}.
        slots:
          action: query.action
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/governance/spend/{agent_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check an agent's spend and remaining headroom
      effect: read
      questions:
      - How much has an agent spent in production and how much headroom is left?
      - Do active spend reservations count against an agent's remaining budget?
      instructions:
      - text: Show production spend, reservations and headroom for agent {agent_id}.
        slots:
          agent_id: path.agent_id
      - text: How much spending room does agent {agent_id} have left.
        slots:
          agent_id: path.agent_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agents/{agent_id}/spend-policy/check'].post
  update:
    x-apievangelist-phrasing:
      intent: Simulate a spend-policy check for an agent
      effect: read
      questions:
      - Would a given spend amount pass an agent's governance policy?
      - Does simulating a spend check reserve any funds?
      instructions:
      - text: Simulate whether agent {agent_id} may spend {amount_usdc} USDC.
        slots:
          agent_id: path.agent_id
          amount_usdc: requestBody.amount_usdc
      - text: Check if agent {agent_id} could spend {amount_usdc} USDC with seller {seller_id} in category {category}.
        slots:
          agent_id: path.agent_id
          amount_usdc: requestBody.amount_usdc
          seller_id: requestBody.seller_id
          category: requestBody.category
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/external-marketplace-liquidity'].get
  update:
    x-apievangelist-phrasing:
      intent: Read external marketplace liquidity metrics
      effect: read
      questions:
      - What liquidity do we see on external marketplaces?
      - Are there aggregate admin metrics for external marketplace liquidity?
      instructions:
      - text: Show the admin external marketplace liquidity metrics.
      - text: Report aggregate liquidity across external marketplaces.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/registry-presence/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the registry-presence monitor status
      effect: read
      questions:
      - Is live fetching turned on for the registry-presence monitor?
      - Which surfaces and targets does the registry-presence monitor expect?
      instructions:
      - text: Show the registry-presence monitor status and flag state.
      - text: Tell me how many registry targets the presence monitor tracks.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/registry-presence/run'].post
  update:
    x-apievangelist-phrasing:
      intent: Run the registry-presence monitor
      effect: write
      questions:
      - Can I check whether Agoragentic shows up in the agent registries?
      - Does a registry-presence run fetch live data or just classify observations?
      instructions:
      - text: Run the registry-presence monitor with live set to {live}.
        slots:
          live: requestBody.live
      - text: Run a presence check against {base_url}, treating records older than {stale_after_days} days as stale.
        slots:
          base_url: requestBody.base_url
          stale_after_days: requestBody.stale_after_days
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/evidence'].get
  update:
    x-apievangelist-phrasing:
      intent: List federation identity evidence for review
      effect: read
      questions:
      - Which remote federation identities are waiting for owner review?
      - Are expired federation evidence rows left out of the pending list?
      instructions:
      - text: List federation identity evidence with status {status}.
        slots:
          status: query.status
      - text: Show {limit} federation evidence rows starting at offset {offset}.
        slots:
          limit: query.limit
          offset: query.offset
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/evidence/{evidenceId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one federation identity evidence row
      effect: read
      questions:
      - Can I inspect a single federation evidence record before accepting it?
      - Is expired federation evidence still viewable?
      instructions:
      - text: Show federation evidence {evidenceId}.
        slots:
          evidenceId: path.evidenceId
      - text: Open evidence row {evidenceId} for owner review.
        slots:
          evidenceId: path.evidenceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/propose'].post
  update:
    x-apievangelist-phrasing:
      intent: Propose a remote agent for federation
      effect: write
      questions:
      - How do I start federating with a remote agent from its Agent Card?
      - Is the remote Agent Card scanned for traps before I see it?
      instructions:
      - text: Propose federation evidence from the Agent Card at {agent_card_url} for relationship {relationship_id}.
        slots:
          agent_card_url: requestBody.agent_card_url
          relationship_id: requestBody.relationship_id
      - text: Fetch and store the remote Agent Card {agent_card_url} as a federation proposal.
        slots:
          agent_card_url: requestBody.agent_card_url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/accept'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept federation evidence and issue a challenge
      effect: write
      questions:
      - What happens when I approve a proposed federation identity?
      - Does accepting federation evidence pin the remote key?
      instructions:
      - text: Accept federation evidence {evidence_id} under owner approval {owner_approval_ref}.
        slots:
          evidence_id: requestBody.evidence_id
          owner_approval_ref: requestBody.owner_approval_ref
      - text: Approve evidence {evidence_id} and issue its key-control challenge.
        slots:
          evidence_id: requestBody.evidence_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/challenge-response'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit a federation key-control challenge response
      effect: write
      questions:
      - How is a remote agent's answer to a key-control challenge verified?
      - Can a federation challenge be consumed more than once?
      instructions:
      - text: Submit the response to challenge {identity_challenge_id} for relationship {relationship_id} from {remote_origin}.
        slots:
          identity_challenge_id: requestBody.identity_challenge_id
          relationship_id: requestBody.relationship_id
          remote_origin: requestBody.remote_origin
      - text: Consume challenge {identity_challenge_id} with evidence {evidence} and binding {binding}.
        slots:
          identity_challenge_id: requestBody.identity_challenge_id
          evidence: requestBody.evidence
          binding: requestBody.binding
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/refresh'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh stored federation evidence
      effect: write
      questions:
      - Can I re-fetch a remote Agent Card to get fresh federation evidence?
      - What happens when stored federation evidence goes stale?
      instructions:
      - text: Refresh federation evidence {evidence_id} from the original Agent Card.
        slots:
          evidence_id: requestBody.evidence_id
      - text: Re-fetch the Agent Card behind evidence {evidence_id} and store a new reviewable row.
        slots:
          evidence_id: requestBody.evidence_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/revoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Revoke a federation key and binding
      effect: destructive
      questions:
      - How can I cut off a federated remote agent's verified binding?
      - Which active key id do I need to revoke a federation relationship?
      instructions:
      - text: Revoke the federation key for relationship {relationship_id} at {remote_origin}.
        slots:
          relationship_id: requestBody.relationship_id
          remote_origin: requestBody.remote_origin
      - text: Revoke relationship {relationship_id} at {remote_origin} because {revocation_reason}.
        slots:
          relationship_id: requestBody.relationship_id
          remote_origin: requestBody.remote_origin
          revocation_reason: requestBody.revocation_reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/declare-need'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a federation need for a remote origin
      effect: write
      questions:
      - Can I record what we need from a federated partner without sending anything to them?
      - Is a declared federation need sent to the remote origin?
      instructions:
      - text: Declare need {need} for relationship {relationship_id} at {remote_origin}.
        slots:
          need: requestBody.need
          relationship_id: requestBody.relationship_id
          remote_origin: requestBody.remote_origin
      - text: Record an inert federation need for {remote_origin}.
        slots:
          remote_origin: requestBody.remote_origin
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/capability-exchange/canaries'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a federation capability-exchange canary
      effect: write
      questions:
      - Can I trial reading a federated partner's capabilities within a 24-hour window?
      - How many pulls does a capability-exchange canary allow?
      instructions:
      - text: Activate a capability-exchange canary for relationship {relationship_id} from {starts_at} to {ends_at}.
        slots:
          relationship_id: requestBody.relationship_id
          starts_at: requestBody.starts_at
          ends_at: requestBody.ends_at
      - text: Start a capability-exchange canary on {relationship_id} with owner approval {owner_approval_ref}.
        slots:
          relationship_id: requestBody.relationship_id
          owner_approval_ref: requestBody.owner_approval_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/capability-exchange/canaries/{canaryId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a capability-exchange canary
      effect: read
      questions:
      - Which pull receipts has a capability-exchange canary collected so far?
      - What state is my capability-exchange canary in?
      instructions:
      - text: Show capability-exchange canary {canaryId} and its pull receipts.
        slots:
          canaryId: path.canaryId
      - text: Get the status of capability-exchange canary {canaryId}.
        slots:
          canaryId: path.canaryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/capability-exchange/canaries/{canaryId}/pull'].post
  update:
    x-apievangelist-phrasing:
      intent: Pull capabilities through a canary
      effect: write
      questions:
      - What does a capability-exchange pull fetch from the partner's origin?
      - Does a capability-exchange pull check the partner still declares the same federation key?
      instructions:
      - text: Perform one capability-exchange pull on canary {canaryId}.
        slots:
          canaryId: path.canaryId
      - text: Fetch the partner's Agent Card and x402 catalog through capability canary {canaryId}.
        slots:
          canaryId: path.canaryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/capability-exchange/canaries/{canaryId}/revoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Revoke a capability-exchange canary
      effect: destructive
      questions:
      - Does closing a capability-exchange canary also end the federation relationship?
      - How do I shut down a capability-exchange canary early?
      instructions:
      - text: Revoke capability-exchange canary {canaryId} because {reason}.
        slots:
          canaryId: path.canaryId
          reason: requestBody.reason
      - text: Close capability canary {canaryId} and its public-feed gate.
        slots:
          canaryId: path.canaryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/metadata-observation/canaries'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a metadata observation window
      effect: write
      questions:
      - Can I observe a counterparty's public Agent Card and discovery document with their consent?
      - How far apart must metadata observation pulls be?
      instructions:
      - text: Create a metadata observation for {counterparty_id} watching {agent_card_url} and {discovery_url}.
        slots:
          counterparty_id: requestBody.counterparty_id
          agent_card_url: requestBody.agent_card_url
          discovery_url: requestBody.discovery_url
      - text: Schedule metadata observation of {remote_origin} from {starts_at} to {ends_at} under operator consent {operator_consent_ref} and approval {owner_approval_ref}.
        slots:
          remote_origin: requestBody.remote_origin
          starts_at: requestBody.starts_at
          ends_at: requestBody.ends_at
          operator_consent_ref: requestBody.operator_consent_ref
          owner_approval_ref: requestBody.owner_approval_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/metadata-observation/canaries/{canaryId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a metadata observation and receipts
      effect: read
      questions:
      - What public-safe receipts has a metadata observation recorded?
      - Is my metadata observation window still active?
      instructions:
      - text: Show metadata observation {canaryId} and its receipts.
        slots:
          canaryId: path.canaryId
      - text: Get the state of metadata observation window {canaryId}.
        slots:
          canaryId: path.canaryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/metadata-observation/canaries/{canaryId}/pull'].post
  update:
    x-apievangelist-phrasing:
      intent: Perform a paired metadata observation pull
      effect: write
      questions:
      - Does a metadata observation pull follow redirects or retry?
      - What gets fetched when I trigger a metadata observation pull?
      instructions:
      - text: Run one paired metadata pull for observation {canaryId}.
        slots:
          canaryId: path.canaryId
      - text: Fetch both stored documents once for metadata observation {canaryId}.
        slots:
          canaryId: path.canaryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-federation/metadata-observation/canaries/{canaryId}/revoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Revoke a metadata observation window
      effect: destructive
      questions:
      - Can I cancel a scheduled metadata observation before it runs?
      - Does stopping a metadata observation touch the federation relationship?
      instructions:
      - text: Revoke metadata observation {canaryId} because {reason}.
        slots:
          canaryId: path.canaryId
          reason: requestBody.reason
      - text: Close the metadata observation window {canaryId} now.
        slots:
          canaryId: path.canaryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/events/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get live event-stream connection counts
      effect: read
      questions:
      - How many agents are connected to the server-sent events stream right now?
      - Which agents hold open SSE connections?
      instructions:
      - text: Show active SSE connection counts by agent.
      - text: Report current event-stream connections.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-graph/federation-steward/intake-relay/approvals'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve relaying an intake to an owned agent
      effect: write
      questions:
      - How do I route a qualified intake to one of our owned agents' inboxes?
      - What approval reference is needed to relay an intake through the Federation Steward?
      instructions:
      - text: Approve relaying intake {intake_id} to agent {recipient_agent_id} under approval {owner_approval_ref}.
        slots:
          intake_id: requestBody.intake_id
          recipient_agent_id: requestBody.recipient_agent_id
          owner_approval_ref: requestBody.owner_approval_ref
      - text: Send intake {intake_id} to owned agent {recipient_agent_id} for review.
        slots:
          intake_id: requestBody.intake_id
          recipient_agent_id: requestBody.recipient_agent_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-graph/federation-steward/intake-relay/approvals/{intakeId}/revoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Revoke an intake relay approval
      effect: destructive
      questions:
      - Can I take back an approval that relayed an intake to an owned agent?
      - Does the recipient agent see when an intake relay approval is revoked?
      instructions:
      - text: Revoke the relay approval for intake {intakeId} with reference {revocation_ref}.
        slots:
          intakeId: path.intakeId
          revocation_ref: requestBody.revocation_ref
      - text: Cancel the intake-to-relay approval on {intakeId}.
        slots:
          intakeId: path.intakeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/receipts/propagation'].get
  update:
    x-apievangelist-phrasing:
      intent: Check receipt propagation against the Day-25 gate
      effect: read
      questions:
      - How many public receipts have been fetched by someone other than the buyer?
      - Are we meeting the Day-25 receipt propagation gate?
      instructions:
      - text: Report receipt propagation over the last {days} days.
        slots:
          days: query.days
      - text: Show which receipts were read by a second client.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/metrics/snapshot'].post
  update:
    x-apievangelist-phrasing:
      intent: Capture a public metrics snapshot now
      effect: write
      questions:
      - Can I take a metrics snapshot on demand instead of waiting for the scheduler?
      - What goes into a manually captured metrics snapshot?
      instructions:
      - text: Capture a public metrics snapshot right now.
      - text: Take a manual stats snapshot and append it to the history.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/metrics/snapshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List saved public metrics snapshots
      effect: read
      questions:
      - Where can I browse previously captured public metrics snapshots?
      - Can I list metrics snapshots without their full payloads?
      instructions:
      - text: List the last {limit} metrics snapshots.
        slots:
          limit: query.limit
      - text: Show metrics snapshots with include_payload set to {include_payload}.
        slots:
          include_payload: query.include_payload
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/gates/day25'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the Day-25 recovery gates report
      effect: read
      questions:
      - Where do the three Day-25 recovery gates stand?
      - How many external settlements came from organic, non-owner wallets?
      instructions:
      - text: Show the Day-25 gates dashboard for the last {days} days.
        slots:
          days: query.days
      - text: Report all three Day-25 recovery gates.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/revenue-density'].get
  update:
    x-apievangelist-phrasing:
      intent: Read revenue-density economics
      effect: read
      questions:
      - Is paid-call density high enough to cover hosted runtime and verification costs?
      - Why would the revenue-density report mark economics as incomplete?
      instructions:
      - text: Show revenue density over {days} days with monthly runtime cost {monthly_cloud_runtime_cost_usdc} USDC.
        slots:
          days: query.days
          monthly_cloud_runtime_cost_usdc: query.monthly_cloud_runtime_cost_usdc
      - text: Compute revenue-density economics using verification cost {verification_cost_per_run_usdc} and operator rate {operator_hourly_rate_usdc}.
        slots:
          verification_cost_per_run_usdc: query.verification_cost_per_run_usdc
          operator_hourly_rate_usdc: query.operator_hourly_rate_usdc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/golden-loop/revenue-sources'].get
  update:
    x-apievangelist-phrasing:
      intent: Break down Golden Loop revenue by source
      effect: read
      questions:
      - Which revenue sources feed the Golden Loop, and is canary revenue kept separate?
      - Which revenue sources failed to report data?
      instructions:
      - text: List Golden Loop revenue sources for the last {days} days.
        slots:
          days: query.days
      - text: Show revenue sources assuming {operator_minutes_per_launch} operator minutes per launch.
        slots:
          operator_minutes_per_launch: query.operator_minutes_per_launch
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/nudge-eligibility'].get
  update:
    x-apievangelist-phrasing:
      intent: Check which stalled launches could be nudged
      effect: read
      questions:
      - Which incomplete Agent OS launches would qualify for a resume reminder?
      - Can the nudge eligibility report actually send reminders?
      instructions:
      - text: Show resume-nudge eligibility with a {cooldown_hours}-hour cooldown.
        slots:
          cooldown_hours: query.cooldown_hours
      - text: List stalled launch sessions eligible or suppressed for a nudge.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/owner-reactivation'].get
  update:
    x-apievangelist-phrasing:
      intent: See which stuck owners came back to launch
      effect: read
      questions:
      - Did owners with stuck launches return and click Continue Launch?
      - What reactivation evidence exists for resumable Agent OS launches?
      instructions:
      - text: Show owner reactivation evidence for up to {limit} launch sessions.
        slots:
          limit: query.limit
      - text: Report which stalled owners saw the resume banner and succeeded.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-os/ops-summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the consolidated Agent OS ops summary
      effect: read
      questions:
      - What is the operational state of hosted runtimes and work graphs across Agent OS?
      - Is there one snapshot covering Market Intelligence runs and marketplace history quality?
      instructions:
      - text: Give me the Agent OS ops summary.
      - text: Show the ops summary including the {limit} most recent work graphs.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-lifecycle'].get
  update:
    x-apievangelist-phrasing:
      intent: Read registration-to-retention lifecycle report
      effect: read
      questions:
      - How many registered agents go on to be retained?
      - Where can I see lifecycle attribution events from sign-up onward?
      instructions:
      - text: Show the agent lifecycle report for the last {days} days.
        slots:
          days: query.days
      - text: Get up to {limit} agent lifecycle attribution rows.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-trap-events'].get
  update:
    x-apievangelist-phrasing:
      intent: List Agent Trap Shield events
      effect: read
      questions:
      - Which requests or provider outputs did the Agent Trap Shield block?
      - Can I filter trap events by severity or trap class?
      instructions:
      - text: List trap events with severity {severity}.
        slots:
          severity: query.severity
      - text: Show Agent Trap Shield events for invocation {invocation_id}.
        slots:
          invocation_id: query.invocation_id
      - text: List blocked trap events of class {trap_class} on route {route}.
        slots:
          trap_class: query.trap_class
          route: query.route
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-participation/cohorts'].get
  update:
    x-apievangelist-phrasing:
      intent: Read Agent 360 participation cohorts
      effect: read
      questions:
      - How are agents split across participation cohorts in the marketplace?
      - How much marketplace history comes from test or canary agents versus customers?
      instructions:
      - text: Show agent participation cohorts for the last {days} days.
        slots:
          days: query.days
      - text: Get Agent 360 cohorts with up to {limit} rows.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/agent-participation/history-quality'].get
  update:
    x-apievangelist-phrasing:
      intent: Find marketplace history quality conflicts
      effect: read
      questions:
      - Are there funded agents that are suspended or banned agents that still earned?
      - Which active listings have failed runtime proof?
      instructions:
      - text: Report marketplace history quality conflicts over {days} days.
        slots:
          days: query.days
      - text: List up to {limit} polluted history conflicts.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/hosting/deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List hosted Agent OS deployments
      effect: read
      questions:
      - Which hosted Agent OS deployments are in the operator queue?
      - Can I filter hosted deployments by status or hosting target?
      instructions:
      - text: List hosted deployments with status {status}.
        slots:
          status: query.status
      - text: Show hosted deployments on target {hosting_target} with provider {provider_name}.
        slots:
          hosting_target: query.hosting_target
          provider_name: query.provider_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/hosting/deployments/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one hosted deployment
      effect: read
      questions:
      - What are the details of a specific hosted Agent OS deployment?
      - Can operators open a single hosted deployment record?
      instructions:
      - text: Show hosted deployment {id}.
        slots:
          id: path.id
      - text: Fetch the operator view of deployment {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/hosting/deployments/{id}/lifecycle/recovery'].get
  update:
    x-apievangelist-phrasing:
      intent: Inspect an uncertain lifecycle operation
      effect: read
      questions:
      - Which lifecycle operation is stuck in an uncertain state on a hosted deployment?
      - What worker and fence evidence is bound to an unresolved lifecycle operation?
      instructions:
      - text: Show unresolved lifecycle recovery for deployment {id}.
        slots:
          id: path.id
      - text: Inspect the uncertain lifecycle operation on hosted deployment {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/hosting/deployments/{id}/lifecycle/recovery/reconcile'].post
  update:
    x-apievangelist-phrasing:
      intent: Reconcile an uncertain lifecycle operation
      effect: write
      questions:
      - How do I resolve a hosted lifecycle operation whose outcome is unknown?
      - What evidence must accompany a lifecycle reconciliation?
      instructions:
      - text: Reconcile operation {operation_id} on deployment {id} with resolution {resolution}.
        slots:
          operation_id: requestBody.operation_id
          id: path.id
          resolution: requestBody.resolution
      - text: Resolve lifecycle operation {operation_id} for worker {worker_id} with fence {fence_token} and evidence {evidence}.
        slots:
          operation_id: requestBody.operation_id
          worker_id: requestBody.worker_id
          fence_token: requestBody.fence_token
          evidence: requestBody.evidence
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/hosting/deployments/{id}/approve'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve a platform-hosted deployment
      effect: write
      questions:
      - What does operator approval record for a platform-hosted deployment?
      - Does approving a hosted deployment verify the owner's billing authorization?
      instructions:
      - text: Record operator approval for hosted deployment {id}.
        slots:
          id: path.id
      - text: Approve deployment {id} for hosting.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/hosting/deployments/{id}/provision'].post
  update:
    x-apievangelist-phrasing:
      intent: Provision the managed runtime for a deployment
      effect: write
      questions:
      - How do I actually provision the runtime for an approved hosted deployment?
      - Is an idempotency key required when provisioning a hosted runtime?
      instructions:
      - text: Provision the managed runtime for deployment {id}.
        slots:
          id: path.id
      - text: Provision deployment {id} with idempotency key {Idempotency-Key}.
        slots:
          id: path.id
          Idempotency-Key: header.Idempotency-Key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/hosting/deployments/{id}/runtime-proxy-cutover'].post
  update:
    x-apievangelist-phrasing:
      intent: Retry or abandon a failed runtime proxy cutover
      effect: write
      questions:
      - What can I do when a native runtime proxy cutover needs a rollback?
      - Is abandoning a failed proxy cutover permanent?
      instructions:
      - text: Take action {action} on the failed proxy cutover for deployment {id}.
        slots:
          action: requestBody.action
          id: path.id
      - text: Retry the proxy cutover on deployment {id} with replacement image {replacement_image_digest}.
        slots:
          id: path.id
          replacement_image_digest: requestBody.replacement_image_digest
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/hosting/deployments/{id}/runtime-actions/{requestId}/claim'].get
  update:
    x-apievangelist-phrasing:
      intent: Inspect a native runtime action claim
      effect: read
      questions:
      - What is the execution and expiry state of a runtime action claim?
      - Did a native runtime action complete before its lease ran out?
      instructions:
      - text: Show the runtime action claim {requestId} on deployment {id}.
        slots:
          requestId: path.requestId
          id: path.id
      - text: Check claim state for runtime request {requestId} on deployment {id}.
        slots:
          requestId: path.requestId
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/hosting/deployments/{id}/runtime-actions/{requestId}/recover'].post
  update:
    x-apievangelist-phrasing:
      intent: Recover or abandon an expired runtime action
      effect: write
      questions:
      - How do I recover a runtime action whose lease expired mid-execution?
      - Do I have to confirm no effect happened before retrying an expired runtime action?
      instructions:
      - text: Apply {action} to expired runtime action {requestId} on deployment {id} with evidence {evidence_ref}.
        slots:
          action: requestBody.action
          requestId: path.requestId
          id: path.id
          evidence_ref: requestBody.evidence_ref
      - text: Retry runtime action {requestId} on deployment {id}, confirming no effect is {confirmed_no_effect}.
        slots:
          requestId: path.requestId
          id: path.id
          confirmed_no_effect: requestBody.confirmed_no_effect
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/hosting/deployments/{id}/smoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a smoke check on a hosted runtime
      effect: write
      questions:
      - How can I check that a hosted runtime is reachable before activating it?
      - What sets a hosted deployment's runtime trust to reachable or failed?
      instructions:
      - text: Run the hosted smoke check on deployment {id}.
        slots:
          id: path.id
      - text: Health-check the live runtime for deployment {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/admin/hosting/deployments/{id}/activate'].post
  update:
    x-apievangelist-phrasing:
      intent: Activate a hosted deployment and publish it
      effect: write
      questions:
      - When does activating a hosted deployment actually publish its listing?
      - Can I evaluate provider readiness without publishing the hosted listing?
      instructions:
      - text: Activate hosted deployment {id}.
        slots:
          id: path.id
      - text: Activate deployment {id} with publish_listing set to {publish_listing}.
        slots:
          id: path.id
          publish_listing: requestBody.publish_listing
      method: generated
      generated: '2026-09-26'