{"uid":"cap_s0SdM82V0Xt536vn1_bh-","slug":"x402-endpoints-agent-action-preflight-clearance-cb4d6388","name":"x402-endpoints Agent Action Preflight Clearance","description":"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.","url":"https://x402-endpoints.onrender.com/agent/clearance?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","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"}}}}},"responseSchema":{"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":"<hex>","public_key":"5b77...9f9d"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":{"p10Cents":"25.0000","medianCents":"25.0000","p90Cents":"25.0000","minCents":"25.0000","maxCents":"25.0000","p95Cents":"25.0000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3gEJCW-wo1Rj5lJoIzrkx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T00:39:23.105Z","isFirstParty":false,"canonicalSlug":"x402-endpoints-agent-action-preflight-clearance-cb4d6388"}