{"uid":"cap_RnWmlS5yvcHjrvBLBcTku","slug":"nomos-agent-action-preflight-check-5731d79d","name":"Nomos Agent Action Preflight Check","description":"Machine-payable service intelligence for discovering, verifying, and monitoring identity, risk, authorization, execution-preflight, and evidence APIs before autonomous agents spend.","url":"https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/agent/action-preflight","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","maxLength":500,"minLength":1,"description":"Human-readable target, command, endpoint, domain, or resource."},"agent_id":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,128}$","description":"Caller-defined agent or principal id."},"risk_score":{"type":"string","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","description":"Side-effecting action the agent wants to run."},"amount_usdc":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Optional payment, spend, or value at risk."},"environment":{"enum":["local","dev","staging","production","external"],"type":"string","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":{"network":{"type":"string"},"product":{"type":"string"},"activity":{"type":"object"},"identity":{"type":"object"},"assessment":{"type":"object"},"provenance":{"type":"object"}}}}}}},"responseSchema":{"type":"json","example":{"network":"eip155:8453","product":"agent-action-preflight","assessment":{"flags":[],"risk_level":"low","risk_score":0}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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":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_0Luha7Sh0cRnAjNdyRbpq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Evaluates an agent's proposed action (tool call, shell command, wallet operation, etc.) for identity, risk, and authorization before execution.","exampleAgentPrompt":"Before my agent executes a wallet action targeting 'usdc-transfer.example.com' in the production environment involving 50.00 USDC, run a preflight risk check and tell me the risk level and any flags.","exampleUseCases":[{"title":"Guard agent wallet spend","prompt":"My agent is about to make an x402_purchase for 25.00 USDC targeting 'api.datavendor.io' in production — run a preflight check for agent ID 'agent-trader-01' and tell me the risk score and whether it's safe to proceed."},{"title":"Screen autonomous shell command","prompt":"Before my agent runs a shell command targeting 'rm -rf /var/tmp/cache' in the staging environment, do a risk preflight check and flag anything suspicious."},{"title":"Pre-authorize agent email action","prompt":"My agent 'newsletter-bot' wants to send an email to 'subscribers@list.com' in the production environment — can you run a preflight assessment and tell me the risk level before it goes out?"}],"resultDescription":"Returns a JSON object containing a risk_level (e.g. 'low', 'medium', 'high'), a numeric risk_score (0–100), a list of flags indicating specific policy concerns, plus optional identity, activity, assessment, and provenance sub-objects describing the evaluated action context.","failureModes":["Missing required query parameters (action_type or target) returns a 400 validation error","Invalid action_type enum value returns schema validation failure","Payment not included or insufficient USDC returns 402 Payment Required","Malformed agent_id pattern (non-alphanumeric) causes parameter rejection","Extremely high-risk actions may return a 'block' recommendation rather than an error, requiring human_approval_ref"],"whenToPreferThis":"Use this endpoint when an autonomous agent needs a real-time, pay-per-use preflight gate before executing any side-effecting action — especially wallet operations, shell commands, deployments, or external API calls. Prefer it over static rule engines when you need dynamic risk scoring with identity and provenance context baked in, and when operating on the Base blockchain ecosystem with x402 micropayment support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:04:16.590Z","isFirstParty":false}