# 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' - target: $.paths['/agent-os/sandbox-provisioning-approval-gates/{sandbox_provisioning_approval_id}/archive'].post update: x-apievangelist-phrasing: intent: Archive a sandbox provisioning approval effect: write questions: - Can I archive an outdated provisioning approval without deleting it? - Is an idempotency key needed to archive an approval gate? instructions: - text: Archive sandbox provisioning approval {sandbox_provisioning_approval_id}. slots: sandbox_provisioning_approval_id: path.sandbox_provisioning_approval_id - text: Move approval gate {sandbox_provisioning_approval_id} to the archive. slots: sandbox_provisioning_approval_id: path.sandbox_provisioning_approval_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/sandbox-provisioning-approval-gate-summary'].get update: x-apievangelist-phrasing: intent: Count provisioning approvals by state effect: read questions: - How many sandbox provisioning approvals are active, revoked or archived? - Is there an aggregate count of approval gates by state? instructions: - text: Summarize sandbox provisioning approvals by state. - text: Give me counts of approval gates per state. method: generated generated: '2026-09-26' - target: $.paths['/agent-os/shared-runtime-lane/deployments/{deployment_id}/domain-edge-case-proof-preview'].post update: x-apievangelist-phrasing: intent: Preview domain edge-case proof scenarios effect: read questions: - Would my hosted agent pass its domain edge-case scenarios, before I record a proof? - Can I preview edge-case proof readiness without writing anything? instructions: - text: Preview domain edge-case proofs for deployment {deployment_id} with scenarios {scenarios}. slots: deployment_id: path.deployment_id scenarios: requestBody.scenarios - text: Dry-run edge-case scenarios {scenarios} on {deployment_id} for owner {owner_id}. slots: scenarios: requestBody.scenarios deployment_id: path.deployment_id owner_id: requestBody.owner_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/shared-runtime-lane/deployments/{deployment_id}/domain-edge-case-proofs'].get update: x-apievangelist-phrasing: intent: List domain edge-case proofs for a deployment effect: read questions: - Which domain edge-case proofs have been recorded for my deployment? - Can I list all edge-case proof records on one hosted agent? instructions: - text: List domain edge-case proofs for deployment {deployment_id}. slots: deployment_id: path.deployment_id - text: Show every edge-case proof record on {deployment_id}. slots: deployment_id: path.deployment_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/shared-runtime-lane/deployments/{deployment_id}/domain-edge-case-proofs'].post update: x-apievangelist-phrasing: intent: Record domain edge-case proof scenarios effect: write questions: - How do I save scenario proofs showing my agent handles domain edge cases? - Does recording an edge-case proof execute the agent or enable public execute? instructions: - text: Record domain edge-case proofs for deployment {deployment_id} with scenarios {scenarios}. slots: deployment_id: path.deployment_id scenarios: requestBody.scenarios - text: Save edge-case scenario proof {scenarios} on {deployment_id} with idempotency key {idempotency_key}. slots: scenarios: requestBody.scenarios deployment_id: path.deployment_id idempotency_key: requestBody.idempotency_key method: generated generated: '2026-09-26' - target: $.paths['/agent-os/shared-runtime-lane/deployments/{deployment_id}/domain-edge-case-proof-summary'].get update: x-apievangelist-phrasing: intent: Get the latest edge-case proof status effect: read questions: - What's the current domain edge-case proof status for my deployment? - Is my hosted agent's latest edge-case proof passing? instructions: - text: Get the domain edge-case proof summary for deployment {deployment_id}. slots: deployment_id: path.deployment_id - text: Tell me the latest edge-case readiness of {deployment_id}. slots: deployment_id: path.deployment_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/domain-edge-case-proofs/{domain_edge_case_proof_id}'].get update: x-apievangelist-phrasing: intent: Read a domain edge-case proof effect: read questions: - What scenarios and results are in a specific edge-case proof? - Where do I open one domain edge-case proof by id? instructions: - text: Open domain edge-case proof {domain_edge_case_proof_id}. slots: domain_edge_case_proof_id: path.domain_edge_case_proof_id - text: Show the scenario results in edge-case proof {domain_edge_case_proof_id}. slots: domain_edge_case_proof_id: path.domain_edge_case_proof_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/domain-edge-case-proofs/{domain_edge_case_proof_id}/receipt'].get update: x-apievangelist-phrasing: intent: Get the receipt for an edge-case proof effect: read questions: - Is there a receipt I can share proving an edge-case proof was recorded? - Where is the receipt tied to a domain edge-case proof? instructions: - text: Get the receipt of edge-case proof {domain_edge_case_proof_id}. slots: domain_edge_case_proof_id: path.domain_edge_case_proof_id - text: Fetch the domain proof receipt for {domain_edge_case_proof_id}. slots: domain_edge_case_proof_id: path.domain_edge_case_proof_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/domain-edge-case-proofs/{domain_edge_case_proof_id}/evidence'].get update: x-apievangelist-phrasing: intent: Read evidence for an edge-case proof effect: read questions: - What evidence backs up a domain edge-case proof? - Can I inspect the evidence refs behind one edge-case scenario proof? instructions: - text: Get the evidence for edge-case proof {domain_edge_case_proof_id}. slots: domain_edge_case_proof_id: path.domain_edge_case_proof_id - text: List the evidence refs attached to domain proof {domain_edge_case_proof_id}. slots: domain_edge_case_proof_id: path.domain_edge_case_proof_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/domain-edge-case-proofs/{domain_edge_case_proof_id}/audit'].get update: x-apievangelist-phrasing: intent: Read the audit log of an edge-case proof effect: read questions: - Who recorded, rechecked or archived a domain edge-case proof? - Is there an audit history for each edge-case proof? instructions: - text: Show the audit log of edge-case proof {domain_edge_case_proof_id}. slots: domain_edge_case_proof_id: path.domain_edge_case_proof_id - text: List audit events for domain proof {domain_edge_case_proof_id}. slots: domain_edge_case_proof_id: path.domain_edge_case_proof_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/domain-edge-case-proofs/{domain_edge_case_proof_id}/recheck'].post update: x-apievangelist-phrasing: intent: Recheck an edge-case proof's readiness effect: write questions: - Can I re-evaluate whether an existing edge-case proof is still ready? - How do I refresh the readiness of a domain edge-case proof? instructions: - text: Recheck readiness of edge-case proof {domain_edge_case_proof_id}. slots: domain_edge_case_proof_id: path.domain_edge_case_proof_id - text: Re-evaluate domain proof {domain_edge_case_proof_id}. slots: domain_edge_case_proof_id: path.domain_edge_case_proof_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/domain-edge-case-proofs/{domain_edge_case_proof_id}/archive'].post update: x-apievangelist-phrasing: intent: Archive a domain edge-case proof effect: write questions: - Can I archive an old edge-case proof without hard-deleting it? - Does archiving a domain proof change public execute or marketplace state? instructions: - text: Archive edge-case proof {domain_edge_case_proof_id}. slots: domain_edge_case_proof_id: path.domain_edge_case_proof_id - text: Move domain proof {domain_edge_case_proof_id} to the archive. slots: domain_edge_case_proof_id: path.domain_edge_case_proof_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/shared-runtime-lane/deployments/{deployment_id}/divigent-wallet-proof-preview'].post update: x-apievangelist-phrasing: intent: Preview a Divigent wallet-float proof effect: read questions: - Would my deployment's Divigent wallet float pass its reserve floor check? - Can I preview a Divigent wallet proof without signing or broadcasting anything? instructions: - text: Preview a Divigent wallet proof for deployment {deployment_id}. slots: deployment_id: path.deployment_id - text: Dry-run the Divigent proof for wallet {wallet_address} on {chain} with reserve floor {reserve_floor_usdc} USDC for {deployment_id}. slots: wallet_address: requestBody.wallet_address chain: requestBody.chain reserve_floor_usdc: requestBody.reserve_floor_usdc deployment_id: path.deployment_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/shared-runtime-lane/deployments/{deployment_id}/divigent-wallet-proofs'].get update: x-apievangelist-phrasing: intent: List Divigent wallet proofs for a deployment effect: read questions: - Which Divigent wallet-float proofs are on record for my deployment? - Can I list all saved Divigent proofs for one hosted agent? instructions: - text: List Divigent wallet proofs for deployment {deployment_id}. slots: deployment_id: path.deployment_id - text: Show every saved Divigent float proof on {deployment_id}. slots: deployment_id: path.deployment_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/shared-runtime-lane/deployments/{deployment_id}/divigent-wallet-proofs'].post update: x-apievangelist-phrasing: intent: Record a Divigent wallet-float proof effect: write questions: - How do I save a durable proof of my deployment's Divigent wallet balance and withdrawal capacity? - Does recording a Divigent proof move funds or sign transactions? instructions: - text: Record a Divigent wallet proof for deployment {deployment_id}. slots: deployment_id: path.deployment_id - text: Save a Divigent proof for wallet {wallet_address} with balance {wallet_usdc_balance} USDC and withdrawal capacity {withdrawal_capacity_usdc} on {deployment_id}. slots: wallet_address: requestBody.wallet_address wallet_usdc_balance: requestBody.wallet_usdc_balance withdrawal_capacity_usdc: requestBody.withdrawal_capacity_usdc deployment_id: path.deployment_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/shared-runtime-lane/deployments/{deployment_id}/divigent-wallet-proof-summary'].get update: x-apievangelist-phrasing: intent: Get the latest Divigent wallet proof status effect: read questions: - Is my deployment's latest Divigent wallet-float proof ready? - What's the current Divigent proof status for a hosted agent? instructions: - text: Get the Divigent wallet proof summary for deployment {deployment_id}. slots: deployment_id: path.deployment_id - text: Tell me the latest Divigent float readiness for {deployment_id}. slots: deployment_id: path.deployment_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/divigent-wallet-proofs/{divigent_wallet_proof_id}'].get update: x-apievangelist-phrasing: intent: Read a Divigent wallet proof effect: read questions: - What balances and reserve floor were captured in a specific Divigent proof? - Where do I open one Divigent wallet proof by id? instructions: - text: Open Divigent wallet proof {divigent_wallet_proof_id}. slots: divigent_wallet_proof_id: path.divigent_wallet_proof_id - text: Show the captured float values in Divigent proof {divigent_wallet_proof_id}. slots: divigent_wallet_proof_id: path.divigent_wallet_proof_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/divigent-wallet-proofs/{divigent_wallet_proof_id}/receipt'].get update: x-apievangelist-phrasing: intent: Get the receipt for a Divigent wallet proof effect: read questions: - Is there a receipt proving a Divigent wallet proof was recorded? - Where can I fetch the receipt for one Divigent float proof? instructions: - text: Get the receipt of Divigent proof {divigent_wallet_proof_id}. slots: divigent_wallet_proof_id: path.divigent_wallet_proof_id - text: Fetch the Divigent wallet receipt for {divigent_wallet_proof_id}. slots: divigent_wallet_proof_id: path.divigent_wallet_proof_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/divigent-wallet-proofs/{divigent_wallet_proof_id}/evidence'].get update: x-apievangelist-phrasing: intent: Read evidence for a Divigent wallet proof effect: read questions: - What sidecar snapshot evidence supports a Divigent wallet proof? - Can I inspect the evidence behind one Divigent float proof? instructions: - text: Get the evidence for Divigent proof {divigent_wallet_proof_id}. slots: divigent_wallet_proof_id: path.divigent_wallet_proof_id - text: List evidence refs attached to Divigent wallet proof {divigent_wallet_proof_id}. slots: divigent_wallet_proof_id: path.divigent_wallet_proof_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/divigent-wallet-proofs/{divigent_wallet_proof_id}/audit'].get update: x-apievangelist-phrasing: intent: Read the audit log of a Divigent wallet proof effect: read questions: - Who rechecked, revoked or archived a Divigent wallet proof? - Is there an audit trail for each Divigent float proof? instructions: - text: Show the audit log of Divigent proof {divigent_wallet_proof_id}. slots: divigent_wallet_proof_id: path.divigent_wallet_proof_id - text: List audit events on Divigent wallet proof {divigent_wallet_proof_id}. slots: divigent_wallet_proof_id: path.divigent_wallet_proof_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/divigent-wallet-proofs/{divigent_wallet_proof_id}/recheck'].post update: x-apievangelist-phrasing: intent: Recheck a Divigent wallet proof effect: write questions: - Can I log a fresh recheck against an existing Divigent wallet proof? - Does rechecking a Divigent proof call the sidecar or sign anything? instructions: - text: Recheck Divigent wallet proof {divigent_wallet_proof_id}. slots: divigent_wallet_proof_id: path.divigent_wallet_proof_id - text: Append a recheck audit event to Divigent proof {divigent_wallet_proof_id}. slots: divigent_wallet_proof_id: path.divigent_wallet_proof_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/divigent-wallet-proofs/{divigent_wallet_proof_id}/revoke'].post update: x-apievangelist-phrasing: intent: Revoke a Divigent wallet proof effect: destructive questions: - How do I invalidate a Divigent wallet proof that is no longer accurate? - Do any funds move when a Divigent proof is revoked? instructions: - text: Revoke Divigent wallet proof {divigent_wallet_proof_id}. slots: divigent_wallet_proof_id: path.divigent_wallet_proof_id - text: Mark Divigent float proof {divigent_wallet_proof_id} as revoked. slots: divigent_wallet_proof_id: path.divigent_wallet_proof_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/divigent-wallet-proofs/{divigent_wallet_proof_id}/archive'].post update: x-apievangelist-phrasing: intent: Archive a Divigent wallet proof effect: write questions: - Can I archive an old Divigent wallet proof while keeping its record? - Is archiving a Divigent proof the same as deleting it? instructions: - text: Archive Divigent wallet proof {divigent_wallet_proof_id}. slots: divigent_wallet_proof_id: path.divigent_wallet_proof_id - text: Move Divigent float proof {divigent_wallet_proof_id} to the archive. slots: divigent_wallet_proof_id: path.divigent_wallet_proof_id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/runs/{run_id}/timeline'].get update: x-apievangelist-phrasing: intent: Read an Agent OS run's event timeline effect: read questions: - What happened, step by step, during one of my agent's runs? - Can I filter a run timeline by event type or workspace? - Does the run timeline expose private payloads? instructions: - text: Show the timeline of Agent OS run {run_id}. slots: run_id: path.run_id - text: List {event_type} timeline events for run {run_id} in deployment {deployment_id}, {limit} at a time. slots: event_type: query.event_type run_id: path.run_id deployment_id: query.deployment_id limit: query.limit method: generated generated: '2026-09-26' - target: $.paths['/internal/agent-os/runs/{run_id}/timeline-events'].post update: x-apievangelist-phrasing: intent: Record an internal run timeline event effect: write questions: - How does an internal service append an observability event to a run's timeline? - Is sensitive metadata redacted before a timeline event is stored? instructions: - text: Record a {event_type} timeline event on run {run_id}. slots: event_type: requestBody.event_type run_id: path.run_id - text: Log a timeline event for run {run_id} with status {status} by actor {actor_id}, linked to receipt {receipt_id}. slots: run_id: path.run_id status: requestBody.status actor_id: requestBody.actor_id receipt_id: requestBody.receipt_id method: generated generated: '2026-09-26'