API Evangelist conversational phrasing for Agoragentic and Marketplace Router Agent OS API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Agoragentic and Marketplace Router Agent OS API
  version: 1.0.0
extends: openapi/agoragentic-com-agent-os-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: 69
- target: $.paths['/agent-os/diagnostics/fixtures'].get
  update:
    x-apievangelist-phrasing:
      intent: List Agent OS diagnostic fixtures
      effect: read
      questions:
      - Which structural diagnostic fixtures can I run against my hosted agent?
      - What test fixtures does Agent OS offer for owner diagnostics?
      instructions:
      - text: List the available Agent OS diagnostic fixtures.
      - text: Show me every structural diagnostic fixture I can pick from.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/diagnostics/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a diagnostics scorecard for a deployment
      effect: read
      questions:
      - Can I see what a diagnostic scorecard would say before recording anything?
      - Does previewing diagnostics write any records or certify my agent?
      instructions:
      - text: Preview diagnostics for deployment {deployment_id}.
        slots:
          deployment_id: requestBody.deployment_id
      - text: Dry-run fixtures {fixture_ids} against deployment {deployment_id} and show the scorecard.
        slots:
          fixture_ids: requestBody.fixture_ids
          deployment_id: requestBody.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/diagnostics/runs'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a diagnostic run for a deployment
      effect: write
      questions:
      - How do I save a structural diagnostic run with its receipt and audit trail?
      - Is an idempotency key required when recording a diagnostic run?
      instructions:
      - text: Record a diagnostic run for deployment {deployment_id} with idempotency key {idempotency_key}.
        slots:
          deployment_id: requestBody.deployment_id
          idempotency_key: requestBody.idempotency_key
      - text: Save a diagnostics run of fixtures {fixture_ids} on deployment {deployment_id}, key {idempotency_key}.
        slots:
          fixture_ids: requestBody.fixture_ids
          deployment_id: requestBody.deployment_id
          idempotency_key: requestBody.idempotency_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/diagnostics/runs/{run_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a recorded diagnostic run
      effect: read
      questions:
      - What were the results of a diagnostic run I recorded earlier?
      - Where can I look up one structural diagnostic run by id?
      instructions:
      - text: Open diagnostic run {run_id}.
        slots:
          run_id: path.run_id
      - text: Show the scorecard results of diagnostics run {run_id}.
        slots:
          run_id: path.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/diagnostics/runs/{run_id}/receipt'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the receipt for a diagnostic run
      effect: read
      questions:
      - Is there a receipt summary I can keep as proof a diagnostic ran?
      - Where is the receipt that a structural diagnostics run produced?
      instructions:
      - text: Get the receipt of diagnostic run {run_id}.
        slots:
          run_id: path.run_id
      - text: Fetch the diagnostics receipt summary for {run_id}.
        slots:
          run_id: path.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/diagnostics/runs/{run_id}/audit'].get
  update:
    x-apievangelist-phrasing:
      intent: Read audit events for a diagnostic run
      effect: read
      questions:
      - Who did what during a diagnostic run, according to its audit log?
      - Can I see the append-only audit trail behind a diagnostics run?
      instructions:
      - text: List the audit events of diagnostic run {run_id}.
        slots:
          run_id: path.run_id
      - text: Show the append-only diagnostics audit trail for {run_id}.
        slots:
          run_id: path.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/diagnostics'].get
  update:
    x-apievangelist-phrasing:
      intent: List diagnostic runs for a deployment
      effect: read
      questions:
      - How many diagnostic runs have been recorded against one of my deployments?
      - Can I see the diagnostics history for a single hosted agent?
      instructions:
      - text: List diagnostic runs for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Show the diagnostics history of deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/first-party-utilities/canaries/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a canary for a first-party utility
      effect: read
      questions:
      - Can I dry-run a fixture canary for a first-party utility candidate without saving it?
      - Does a utility canary preview call providers or tools?
      instructions:
      - text: Preview a fixture canary for utility candidate {candidate_slug}.
        slots:
          candidate_slug: requestBody.candidate_slug
      - text: Dry-run the first-party utility canary for {candidate_slug} without writing records.
        slots:
          candidate_slug: requestBody.candidate_slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/first-party-utilities/canaries/runs'].get
  update:
    x-apievangelist-phrasing:
      intent: List first-party utility canary runs
      effect: read
      questions:
      - Which canary runs exist for first-party utility candidates?
      - Can I filter utility canary runs by candidate or by run state?
      instructions:
      - text: List all first-party utility canary runs.
      - text: Show utility canary runs for candidate {candidate_slug} in state {run_state}.
        slots:
          candidate_slug: query.candidate_slug
          run_state: query.run_state
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/first-party-utilities/canaries/runs'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a first-party utility canary run
      effect: write
      questions:
      - How do I save a deterministic fixture canary for a utility candidate as evidence?
      - Does recording a utility canary publish a listing or change Router ranking?
      instructions:
      - text: Record a utility canary run for {candidate_slug} with idempotency key {idempotency_key}.
        slots:
          candidate_slug: requestBody.candidate_slug
          idempotency_key: requestBody.idempotency_key
      - text: Save the first-party fixture canary for candidate {candidate_slug} as a receipt-backed run, key {idempotency_key}.
        slots:
          candidate_slug: requestBody.candidate_slug
          idempotency_key: requestBody.idempotency_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/first-party-utilities/canaries/runs/{run_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a first-party utility canary run
      effect: read
      questions:
      - What was the outcome of a specific utility canary run?
      - Where do I look up one first-party utility canary by run id?
      instructions:
      - text: Open utility canary run {run_id}.
        slots:
          run_id: path.run_id
      - text: Show the result of first-party utility canary {run_id}.
        slots:
          run_id: path.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/first-party-utilities/canaries/runs/{run_id}/receipt'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the receipt for a utility canary run
      effect: read
      questions:
      - Which receipt proves a first-party utility canary passed?
      - Can I get the canary receipt I need for a Seller OS draft preview?
      instructions:
      - text: Get the receipt for utility canary run {run_id}.
        slots:
          run_id: path.run_id
      - text: Fetch the first-party canary receipt evidence of {run_id}.
        slots:
          run_id: path.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/first-party-utilities/canaries/runs/{run_id}/audit'].get
  update:
    x-apievangelist-phrasing:
      intent: Read audit events for a utility canary run
      effect: read
      questions:
      - What audit events were logged for a first-party utility canary?
      - Can I trace the history of one utility canary run?
      instructions:
      - text: List the audit events of utility canary run {run_id}.
        slots:
          run_id: path.run_id
      - text: Show the first-party canary audit log for {run_id}.
        slots:
          run_id: path.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/first-party-utilities/{candidate_slug}/seller-os-draft-preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a Seller OS draft for a utility candidate
      effect: read
      questions:
      - Is my first-party utility candidate ready to become a Seller OS listing draft?
      - What canary evidence does a Seller OS draft preview require?
      instructions:
      - text: Preview the Seller OS draft packet for utility candidate {candidate_slug}.
        slots:
          candidate_slug: path.candidate_slug
      - text: Build a Seller OS draft preview for {candidate_slug} using canary run {canary_run_id}.
        slots:
          candidate_slug: path.candidate_slug
          canary_run_id: requestBody.canary_run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/paid-surfaces/readiness/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview readiness of a paid surface
      effect: read
      questions:
      - Is my route ready to be offered as a paid surface, based on proofs and spend caps?
      - Can I check paid-surface readiness without calling any paid route?
      instructions:
      - text: Preview paid-surface readiness for my route.
      - text: Dry-run the paid-surface readiness check against my proofs, receipts and spend cap.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/paid-surfaces/readiness/checks'].get
  update:
    x-apievangelist-phrasing:
      intent: List paid-surface readiness checks
      effect: read
      questions:
      - Which paid-surface readiness checks have been recorded for my listings?
      - Can I filter readiness checks by deployment, listing or state?
      instructions:
      - text: List paid-surface readiness checks for listing {listing_id}.
        slots:
          listing_id: query.listing_id
      - text: Show readiness checks in state {check_state} for deployment {deployment_id}.
        slots:
          check_state: query.check_state
          deployment_id: query.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/paid-surfaces/readiness/checks'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a paid-surface readiness check
      effect: write
      questions:
      - How do I save a paid-surface readiness record with its refs and hashes?
      - Does recording a readiness check turn on x402 payments for the route?
      instructions:
      - text: Record a paid-surface readiness check with idempotency key {idempotency_key}.
        slots:
          idempotency_key: requestBody.idempotency_key
      - text: Save the current paid-surface readiness as a record, key {idempotency_key}.
        slots:
          idempotency_key: requestBody.idempotency_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/paid-surfaces/readiness/checks/{check_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a paid-surface readiness check
      effect: read
      questions:
      - What did a specific paid-surface readiness check conclude?
      - Where can I read one readiness check record by id?
      instructions:
      - text: Open paid-surface readiness check {check_id}.
        slots:
          check_id: path.check_id
      - text: Show the outcome of readiness check {check_id}.
        slots:
          check_id: path.check_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/paid-canaries/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a paid canary evidence record
      effect: read
      questions:
      - Can I preview a paid canary proof from x402 payment evidence before saving it?
      - Does a paid canary preview settle or spend anything?
      instructions:
      - text: Preview a paid canary proof record from my route payment evidence.
      - text: Dry-run a paid canary evidence record without recording it.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/paid-canaries/runs'].get
  update:
    x-apievangelist-phrasing:
      intent: List paid canary evidence runs
      effect: read
      questions:
      - Which paid canary evidence records have been saved?
      - Can I see all paid canary runs recorded by the owner?
      instructions:
      - text: List paid canary runs.
      - text: Show every recorded paid canary evidence run.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/paid-canaries/runs'].post
  update:
    x-apievangelist-phrasing:
      intent: Record paid canary evidence
      effect: write
      questions:
      - How do I store a paid canary run and receipt from real payment evidence?
      - Which gate must be enabled before recording paid canary evidence?
      instructions:
      - text: Record a paid canary run with idempotency key {idempotency_key}.
        slots:
          idempotency_key: requestBody.idempotency_key
      - text: Save paid canary evidence with recording gate {paid_canary_recording_enabled} and key {idempotency_key}.
        slots:
          paid_canary_recording_enabled: requestBody.paid_canary_recording_enabled
          idempotency_key: requestBody.idempotency_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/paid-canaries/runs/{run_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a paid canary run
      effect: read
      questions:
      - What evidence was captured in a particular paid canary run?
      - Where can I look up one paid canary record by run id?
      instructions:
      - text: Open paid canary run {run_id}.
        slots:
          run_id: path.run_id
      - text: Show the details of paid canary {run_id}.
        slots:
          run_id: path.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/paid-canaries/runs/{run_id}/receipt'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the receipt for a paid canary run
      effect: read
      questions:
      - Where is the receipt produced by a paid canary run?
      - Can I fetch the proof receipt of one paid canary?
      instructions:
      - text: Get the receipt of paid canary run {run_id}.
        slots:
          run_id: path.run_id
      - text: Fetch the paid canary receipt for {run_id}.
        slots:
          run_id: path.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/paid-canaries/runs/{run_id}/audit'].get
  update:
    x-apievangelist-phrasing:
      intent: Read audit events for a paid canary run
      effect: read
      questions:
      - What audit trail exists for a paid canary run?
      - Who recorded or touched a given paid canary, per its audit events?
      instructions:
      - text: List the audit events of paid canary run {run_id}.
        slots:
          run_id: path.run_id
      - text: Show the paid canary audit log for {run_id}.
        slots:
          run_id: path.run_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/sandbox-provision-preflight/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview sandbox provisioning prerequisites
      effect: read
      questions:
      - Is my deployment ready for sandbox provisioning, before I record a preflight?
      - Does a sandbox preflight preview create any cloud resources?
      instructions:
      - text: Preview the sandbox provision preflight for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Dry-run sandbox provisioning prerequisites on {deployment_id} without saving.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/sandbox-provision-preflight'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a sandbox provision preflight
      effect: write
      questions:
      - How do I record the provider, runtime, image and budget posture before sandbox provisioning?
      - Does saving a sandbox provision preflight actually provision anything?
      instructions:
      - text: Record a sandbox provision preflight for deployment {deployment_id} with idempotency key {idempotency_key}.
        slots:
          deployment_id: path.deployment_id
          idempotency_key: requestBody.idempotency_key
      - text: Save the sandbox preflight artifact for {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/sandbox-provision-preflights'].get
  update:
    x-apievangelist-phrasing:
      intent: List sandbox preflights for a deployment
      effect: read
      questions:
      - Which sandbox provision preflights have been recorded for my deployment?
      - Can I see a redacted list of preflight artifacts for one agent?
      instructions:
      - text: List sandbox provision preflights for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Show all preflight artifacts recorded on {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/sandbox-provision-preflights/{sandbox_provision_preflight_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a sandbox provision preflight
      effect: read
      questions:
      - What does a specific sandbox provision preflight record contain?
      - Where do I open one preflight artifact by id?
      instructions:
      - text: Open sandbox provision preflight {sandbox_provision_preflight_id}.
        slots:
          sandbox_provision_preflight_id: path.sandbox_provision_preflight_id
      - text: Show the recorded posture in preflight {sandbox_provision_preflight_id}.
        slots:
          sandbox_provision_preflight_id: path.sandbox_provision_preflight_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/sandbox-provision-preflights/{sandbox_provision_preflight_id}/evidence'].get
  update:
    x-apievangelist-phrasing:
      intent: Read evidence refs for a sandbox preflight
      effect: read
      questions:
      - What evidence hashes back a sandbox provision preflight?
      - Does preflight evidence include raw logs or secrets?
      instructions:
      - text: Get the evidence refs for sandbox preflight {sandbox_provision_preflight_id}.
        slots:
          sandbox_provision_preflight_id: path.sandbox_provision_preflight_id
      - text: List the no-live-effect evidence hashes on preflight {sandbox_provision_preflight_id}.
        slots:
          sandbox_provision_preflight_id: path.sandbox_provision_preflight_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/sandbox-provision-preflights/{sandbox_provision_preflight_id}/readiness-snapshot'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a sandbox preflight readiness snapshot
      effect: read
      questions:
      - Was the deployment ready at the time a sandbox preflight was recorded?
      - Can I see the readiness snapshot captured with a preflight?
      instructions:
      - text: Get the readiness snapshot for sandbox preflight {sandbox_provision_preflight_id}.
        slots:
          sandbox_provision_preflight_id: path.sandbox_provision_preflight_id
      - text: Show how ready things were when preflight {sandbox_provision_preflight_id} was taken.
        slots:
          sandbox_provision_preflight_id: path.sandbox_provision_preflight_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/sandbox-provision-preflights/{sandbox_provision_preflight_id}/audit'].get
  update:
    x-apievangelist-phrasing:
      intent: Read audit events for a sandbox preflight
      effect: read
      questions:
      - Who created, revoked or archived a sandbox preflight?
      - Is there an audit log for each sandbox provision preflight?
      instructions:
      - text: List audit events for sandbox preflight {sandbox_provision_preflight_id}.
        slots:
          sandbox_provision_preflight_id: path.sandbox_provision_preflight_id
      - text: Show the audit trail of preflight artifact {sandbox_provision_preflight_id}.
        slots:
          sandbox_provision_preflight_id: path.sandbox_provision_preflight_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/sandbox-provision-preflights/{sandbox_provision_preflight_id}/revoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Revoke a sandbox provision preflight
      effect: destructive
      questions:
      - How do I invalidate a sandbox preflight so it can't feed an approval gate?
      - Does revoking a preflight touch any runtime or provider?
      instructions:
      - text: Revoke sandbox provision preflight {sandbox_provision_preflight_id}.
        slots:
          sandbox_provision_preflight_id: path.sandbox_provision_preflight_id
      - text: Mark preflight artifact {sandbox_provision_preflight_id} as revoked.
        slots:
          sandbox_provision_preflight_id: path.sandbox_provision_preflight_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/sandbox-provision-preflights/{sandbox_provision_preflight_id}/archive'].post
  update:
    x-apievangelist-phrasing:
      intent: Archive a sandbox provision preflight
      effect: write
      questions:
      - Can I archive an old sandbox preflight without hard-deleting it?
      - What does archiving a preflight artifact keep?
      instructions:
      - text: Archive sandbox provision preflight {sandbox_provision_preflight_id}.
        slots:
          sandbox_provision_preflight_id: path.sandbox_provision_preflight_id
      - text: Move preflight {sandbox_provision_preflight_id} to the archive, keeping its record.
        slots:
          sandbox_provision_preflight_id: path.sandbox_provision_preflight_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/sandbox-provision-preflight-summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Count sandbox preflights by state
      effect: read
      questions:
      - How many sandbox provision preflights are ready, revoked or archived?
      - Is there an aggregate view of preflight states across deployments?
      instructions:
      - text: Summarize sandbox provision preflights by state.
      - text: Give me the counts of preflight artifacts per state.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/sandbox-provisioning-approval-gate/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a sandbox provisioning approval gate
      effect: read
      questions:
      - What approvals are still missing before my deployment's sandbox can be provisioned?
      - Can I preview the provisioning approval gate without recording it?
      instructions:
      - text: Preview the sandbox provisioning approval gate for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Check approval prerequisites for provisioning {deployment_id} without writing anything.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/sandbox-provisioning-approval-gate'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a sandbox provisioning approval
      effect: write
      questions:
      - How do I record owner approval to provision a sandbox from a ready preflight?
      - Does recording a provisioning approval start the sandbox?
      instructions:
      - text: Record a sandbox provisioning approval for deployment {deployment_id} with idempotency key {idempotency_key}.
        slots:
          deployment_id: path.deployment_id
          idempotency_key: requestBody.idempotency_key
      - text: Save the owner approval gate for provisioning {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/deployments/{deployment_id}/sandbox-provisioning-approval-gates'].get
  update:
    x-apievangelist-phrasing:
      intent: List provisioning approvals for a deployment
      effect: read
      questions:
      - Which sandbox provisioning approvals exist for my deployment?
      - Can I see the approval gate history of a single hosted agent?
      instructions:
      - text: List sandbox provisioning approvals for deployment {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      - text: Show all approval gate artifacts on {deployment_id}.
        slots:
          deployment_id: path.deployment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/sandbox-provisioning-approval-gates/{sandbox_provisioning_approval_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a sandbox provisioning approval
      effect: read
      questions:
      - What was approved in a particular sandbox provisioning approval?
      - Where do I open one provisioning approval by id?
      instructions:
      - text: Open sandbox provisioning approval {sandbox_provisioning_approval_id}.
        slots:
          sandbox_provisioning_approval_id: path.sandbox_provisioning_approval_id
      - text: Show the approved budget and rollback refs in approval {sandbox_provisioning_approval_id}.
        slots:
          sandbox_provisioning_approval_id: path.sandbox_provisioning_approval_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/sandbox-provisioning-approval-gates/{sandbox_provisioning_approval_id}/evidence'].get
  update:
    x-apievangelist-phrasing:
      intent: Read evidence refs for a provisioning approval
      effect: read
      questions:
      - What evidence hashes support a sandbox provisioning approval?
      - Are cloud credentials ever included in approval evidence?
      instructions:
      - text: Get the evidence refs for provisioning approval {sandbox_provisioning_approval_id}.
        slots:
          sandbox_provisioning_approval_id: path.sandbox_provisioning_approval_id
      - text: List evidence hashes attached to approval gate {sandbox_provisioning_approval_id}.
        slots:
          sandbox_provisioning_approval_id: path.sandbox_provisioning_approval_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/sandbox-provisioning-approval-gates/{sandbox_provisioning_approval_id}/risk-card'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the risk card for a provisioning approval
      effect: read
      questions:
      - What risks are flagged on a sandbox provisioning approval?
      - Is there a public-safe risk summary for an approval gate?
      instructions:
      - text: Show the risk card for provisioning approval {sandbox_provisioning_approval_id}.
        slots:
          sandbox_provisioning_approval_id: path.sandbox_provisioning_approval_id
      - text: Get the advisory risk summary on approval {sandbox_provisioning_approval_id}.
        slots:
          sandbox_provisioning_approval_id: path.sandbox_provisioning_approval_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/sandbox-provisioning-approval-gates/{sandbox_provisioning_approval_id}/readiness-snapshot'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a provisioning approval readiness snapshot
      effect: read
      questions:
      - How ready was the deployment when a provisioning approval was recorded?
      - Can I see the readiness snapshot stored with an approval gate?
      instructions:
      - text: Get the readiness snapshot for provisioning approval {sandbox_provisioning_approval_id}.
        slots:
          sandbox_provisioning_approval_id: path.sandbox_provisioning_approval_id
      - text: Show the readiness captured at approval gate {sandbox_provisioning_approval_id}.
        slots:
          sandbox_provisioning_approval_id: path.sandbox_provisioning_approval_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/sandbox-provisioning-approval-gates/{sandbox_provisioning_approval_id}/audit'].get
  update:
    x-apievangelist-phrasing:
      intent: Read audit events for a provisioning approval
      effect: read
      questions:
      - Who rechecked, revoked or archived a provisioning approval?
      - Is there an audit log for each sandbox approval gate?
      instructions:
      - text: List audit events for provisioning approval {sandbox_provisioning_approval_id}.
        slots:
          sandbox_provisioning_approval_id: path.sandbox_provisioning_approval_id
      - text: Show the audit trail of approval gate {sandbox_provisioning_approval_id}.
        slots:
          sandbox_provisioning_approval_id: path.sandbox_provisioning_approval_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/sandbox-provisioning-approval-gates/{sandbox_provisioning_approval_id}/recheck'].post
  update:
    x-apievangelist-phrasing:
      intent: Recheck a sandbox provisioning approval
      effect: write
      questions:
      - Can I re-evaluate a provisioning approval after its inputs changed?
      - Does rechecking an approval gate provision anything?
      instructions:
      - text: Recheck sandbox provisioning approval {sandbox_provisioning_approval_id}.
        slots:
          sandbox_provisioning_approval_id: path.sandbox_provisioning_approval_id
      - text: Re-evaluate approval gate {sandbox_provisioning_approval_id} locally.
        slots:
          sandbox_provisioning_approval_id: path.sandbox_provisioning_approval_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/sandbox-provisioning-approval-gates/{sandbox_provisioning_approval_id}/revoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Revoke a sandbox provisioning approval
      effect: destructive
      questions:
      - How do I withdraw an approval I gave for sandbox provisioning?
      - What changes when a provisioning approval gate is revoked?
      instructions:
      - text: Revoke sandbox provisioning approval {sandbox_provisioning_approval_id}.
        slots:
          sandbox_provisioning_approval_id: path.sandbox_provisioning_approval_id
      - text: Withdraw approval gate {sandbox_provisioning_approval_id}.
        slots:
          sandbox_provisioning_approval_id: path.sandbox_provisioning_approval_id
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (51 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/agoragentic-com/refs/heads/main/overlays/agoragentic-com-agent-os-api-phrasing-overlay.yaml