# x402-endpoints Agent Action Preflight Clearance > x402-endpoints Agent Action Preflight Clearance is a paid API for AI agents from x402-endpoints.onrender.com, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-03). Evaluates a proposed agent action against a deterministic policy engine and returns a structured CLEAR/REVIEW/BLOCK verdict with risk score, reversibility analysis, and a signed clearance packet before the agent executes. ## Facts - Endpoint: GET https://x402-endpoints.onrender.com/agent/clearance?utm_source=zero.xyz - Price: $0.25/call - Payment: x402 - Status: unknown - Last checked: 2026-10-03 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/x402-endpoints-agent-action-preflight-clearance-cb4d6388 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_s0SdM82V0Xt536vn1_bh- Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability x402-endpoints-agent-action-preflight-clearance-cb4d6388 ``` Example prompt: Before I go ahead and transfer 250 USDC to 0xabc123... — can you run a preflight clearance check on that action, flag it as a 'transfer', and tell me if it's safe to proceed or needs human review? ## When to prefer this Use this endpoint when an AI agent is about to take an irreversible, high-stakes, or externally-visible action (delete, transfer, deploy, send, publish) and needs a machine-readable, signed authorization verdict before proceeding. Prefer this over manual human review when you need a deterministic, policy-based preflight gate that returns a signed clearance packet with an evidence hash — especially for financial transfers, destructive database operations, or autonomous agent workflows where auditability and tamper-evident proof of authorization matters. ## Known failure modes - Missing required 'action' query parameter returns validation error - Payment not received or USDC balance insufficient results in 402 response blocking access - Ambiguous action description may result in conservative BLOCK or REVIEW verdict instead of CLEAR - Clearance packet expires after 300 seconds — acting after TTL requires re-calling the endpoint - Unsupported action_type enum value may cause inference fallback or error - Network timeout on render.com cold start may delay response ## How this service works Safety preflight before an agent runs a DESTRUCTIVE, costly or IRREVERSIBLE action (delete, deploy, transfer funds, publish, overwrite): risk assessment + reversibility check + timing + CLEAR/LIMIT/REVIEW/BLOCK verdict + a cryptographically SIGNED ClearancePacket (decision, approved amount, policy version, evidence hash, expiry, rationale) the agent keeps as proof of authorization. Agent action guardrail / clearance / human-in-the-loop gate; stops a mistake costlier than the call price. ## Output A JSON object containing a verdict (CLEAR, REVIEW, or BLOCK), a risk score (0-100), reversibility analysis (reversible, destructive, external effect), a financial band and approved amount, a human-readable rationale, a confidence score, expiry timestamp (TTL 300s), and a signed ed25519 clearance packet with evidence hash and policy version that the agent can pass downstream as proof of authorization. ## Request schema (JSON Schema) ```json { "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", "HEAD", "DELETE" ], "type": "string" }, "queryParams": { "type": "object", "required": [ "action" ], "properties": { "action": { "type": "string", "description": "Plain-language action about to run, e.g. 'delete the production users table'" }, "target": { "type": "string", "description": "Optional target, e.g. a table, address, repo, recipient" }, "context": { "type": "string", "description": "Optional extra context (environment, prior approval, etc.)" }, "amount_usd": { "type": "number", "description": "Monetary stake in USD if applicable, e.g. 250" }, "reversible": { "type": "boolean", "description": "Optional caller hint: is the action reversible? Inferred if omitted" }, "action_type": { "type": "string", "description": "Optional: delete | deploy | send | spend | transfer | publish | email | overwrite | approve | rotate | shutdown | other" } } } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object" } } } } } ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "error": null, "query": { "action": "transfer 250 USDC to 0xabc...", "target": null, "amount_usd": 250, "action_type": "transfer", "reversible_hint": null }, "cached": false, "timing": { "note": "Re-run preflight if you act after expiry; conditions may have changed.", "expiry": "2026-06-30T12:05:00Z", "ttl_seconds": 300, "evaluated_at": "2026-06-30T12:00:00Z" }, "reasons": [ { "code": "REVERSIBLE", "label": "Action appears reversible", "weight": -0.2 }, { "code": "SPEND_HIGH", "label": "Stake $250.00 requires review", "weight": 0.6 } ], "verdict": "REVIEW", "financial": { "band": "moderate", "amount_usd": 250, "approved_amount_usd": 500 }, "rationale": "Allowed but capped: IRREVERSIBLE, moderate financial stake. Stake exceeds the auto limit; approved amount bounded.", "timestamp": "2026-06-30T12:00:00Z", "confidence": 0.9, "disclaimer": "Automated clearance based on a fixed policy and the supplied description. CLEAR is not a guarantee of safety.", "risk_score": 70, "reversibility": { "source": "inferred", "reversible": false, "destructive": false, "external_effect": false }, "data_freshness": { "as_of": "2026-06-30T12:00:00Z", "sources": [ "Local deterministic clearance rules engine (x402-endpoints LOT9)" ], "age_seconds": 0, "retrieved_at": "2026-06-30T12:00:00Z", "deterministic": true, "evidence_hash": "a1b2...", "policy_version": "clearance-policy-2026-06-1" }, "clearance_packet": { "claims": { "kind": "agent_action_clearance", "expiry": "2026-06-30T12:05:00Z", "issuer": "x402-endpoints.onrender.com", "decision": "REVIEW", "issued_at": "2026-06-30T12:00:00Z", "rationale": "Human review required.", "reversible": false, "evidence_hash": "a1b2...", "policy_version": "clearance-policy-2026-06-1", "approved_amount_usd": null }, "algorithm": "ed25519", "available": true, "signature": "", "public_key": "5b77...9f9d" } } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-endpoints-agent-action-preflight-clearance-cb4d6388/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from x402-endpoints.onrender.com](https://www.zero.xyz/host/x402-endpoints.onrender.com/llms.txt)