{"uid":"cap_Wg-pHISJatNP0LGHKvNxc","slug":"no-hands-ai-agentops-guard-action-preflight-01d7852f","name":"NO HANDS AI AgentOps Guard Action Preflight","description":"Return an advisory AgentOps Guard REVIEW/BLOCK result (never ALLOW; not an authorization) before a side-effecting agent action runs.","url":"https://nohands-coinbase-bazaar.bytoken2023.workers.dev/v1/x402/agent/action-preflight?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["action_type","target"],"properties":{"target":{"type":"string","example":"production worker","maxLength":500,"minLength":1,"description":"Human-readable target, command, endpoint, domain, or resource."},"agent_id":{"type":"string","example":"demo-agent","pattern":"^[A-Za-z0-9._:-]{1,128}$","description":"Caller-defined agent or principal id."},"risk_score":{"type":"string","example":"35","pattern":"^[0-9]{1,3}$","description":"Optional caller-supplied 0-100 risk score."},"action_type":{"enum":["tool_call","shell","deploy","dns","email","mcp_call","wallet","x402_purchase","file_write","browser"],"type":"string","example":"deploy","description":"Side-effecting action the agent wants to run."},"amount_usdc":{"type":"string","example":"0.00","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Optional payment, spend, or value at risk."},"environment":{"enum":["local","dev","staging","production","external"],"type":"string","example":"production","description":"Execution environment for the action."},"human_approval_ref":{"type":"string","maxLength":160,"description":"Human approval or ticket reference for elevated actions."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"action":{"type":"object","properties":{"type":{"type":"string"},"target":{"type":"string"},"agent_id":{"type":"string"},"amount_usdc":{"type":"integer"},"environment":{"type":"string"}},"additionalProperties":true},"product":{"type":"string"},"receipt":{"type":["object","null"],"description":"Preflight decision receipt signed with the separate preflight key (key_id nomos-preflight-receipt-key-v1; signed receipt_purpose=preflight_decision, product, decision_nonce; TTL <= 300s). Null when NOMOS_PREFLIGHT_RECEIPT_SIGNING_JWK is not configured. Advisory; never an ALLOW authorization.","additionalProperties":true},"decision":{"type":"string"},"directive":{"type":"object","properties":{"proceed":{"type":"boolean"},"block_execution":{"type":"boolean"},"required_evidence":{"type":"array","items":{"type":"string"}},"require_human_review":{"type":"boolean"}},"additionalProperties":true},"assessment":{"type":"object","properties":{"reasons":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"detail":{"type":"string"},"severity":{"type":"string"}},"additionalProperties":true}},"risk_level":{"type":"string"},"risk_score":{"type":"integer"},"reason_codes":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"expires_at":{"type":"string"},"decision_id":{"type":"string"},"generated_at":{"type":"string"},"authorization":{"type":"object","properties":{"mode":{"type":"string"},"note":{"type":"string"},"inputs_verified":{"type":"boolean"},"ignored_caller_assertions":{"type":"array","items":{"type":"string"}},"is_authorization_decision":{"type":"boolean"},"unverified_caller_assertions":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"consume_token":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$","description":"One-time ownership secret for the consume route; only its SHA-256 is signed. Treat as a secret."},"receipt_error":{"enum":[null,"receipt_signing_key_missing","receipt_signing_key_malformed","receipt_signing_failed"],"type":["string","null"]},"decision_nonce":{"type":"string","pattern":"^[a-f0-9]{32}$","description":"Single-use nonce bound into the signed receipt; consume once via POST /v1/agentic-commerce/preflight/consume."},"policy_version":{"type":"string"},"receipt_status":{"enum":["SIGNED","SIGNING_KEY_UNAVAILABLE","SIGNING_KEY_MALFORMED","SIGNING_FAILED"],"type":"string","description":"SIGNED, or a fail-closed reason (receipt is null): key missing, key malformed, or signing failed."},"schema_version":{"type":"string"},"pricing_version":{"type":"string"},"replay_protection":{"type":"object","additionalProperties":true},"decision_vocabulary":{"type":"string"},"normalized_decision":{"type":"string"}},"x-schema-family":"OPERATION_RUNTIME_RESULT","x-schema-authority":"REPRESENTATIVE_RUNTIME_FIXTURE","additionalProperties":true}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_839N722fC2-Acts34YoxT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns an advisory REVIEW or BLOCK result (never ALLOW) for a proposed side-effecting agent action before it executes, as a pre-execution safety gate.","exampleAgentPrompt":"Before my agent goes ahead and sends that payment request, can you run an AgentOps Guard preflight check on the action to see if it gets a REVIEW or BLOCK advisory?","exampleUseCases":[{"title":"Gate autonomous payment before execution","prompt":"My agent is about to submit a $50 USDC transfer on my behalf — run a Guard preflight on that action first and tell me if it gets REVIEW or BLOCK before we proceed."},{"title":"Safety check before data deletion action","prompt":"Before the agent deletes those database records, I want an AgentOps Guard advisory on the action — will it come back as BLOCK or REVIEW so I can decide whether to proceed?"},{"title":"Policy review for agent API write call","prompt":"My autonomous agent wants to POST to an external webhook and modify third-party state — can you run a preflight guard check on that side-effecting action before it fires?"}],"resultDescription":"An advisory result of either REVIEW or BLOCK (never ALLOW) indicating whether the proposed side-effecting agent action should be held for human review or outright blocked, along with supporting risk context. This is an advisory output only, not an authorization decision.","failureModes":["Missing or malformed action description returns an error or ambiguous assessment","Endpoint may return REVIEW as a conservative default when action intent is unclear","GET method limits payload size for complex action descriptions","Advisory result may be overly conservative, blocking legitimate low-risk actions","Service unavailability returns no advisory, leaving agent without preflight guidance"],"whenToPreferThis":"Use this endpoint when you need a lightweight, advisory safety gate before an agent executes any side-effecting action (payments, writes, deletions, external API calls). It is specifically designed to return only REVIEW or BLOCK — never ALLOW — making it suitable as a conservative pre-execution checkpoint in agentic pipelines where human-in-the-loop or escalation logic follows a non-ALLOW result. Prefer this over generic policy checks when operating in an x402 or AgentOps context on the NO HANDS AI platform.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:29.302Z","isFirstParty":false,"canonicalSlug":"no-hands-ai-agentops-guard-action-preflight-01d7852f"}