{"uid":"cap_xhpksFmky_1RfHaZWJvYG","slug":"2s-io-dev-preflight-command-url-validator-88dbbf96","name":"2s.io Dev Preflight — Command URL Validator","description":"The (most) everything API: 575+ pay-per-call endpoints for AI agents — ground-truth data, a full AI gateway, and agent infrastructure (storage, queues, watchers). USDC via x402, no signup, no API keys, and upto billing: pay actual usage, not the quote.","url":"https://2s.io/api/dev/preflight?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"probe":{"type":"boolean","description":"Also do a live guarded HEAD probe (default false)."},"command":{"type":"string","description":"The shell command to check."}}},"responseSchema":null,"example":{"request":{"probe":true,"command":"curl -sSL https://api.github.com/users/octocat"},"response":{"data":{"ok":true,"items":[{"url":"https://api.github.com/users/octocat","mode":"live","note":"Live check: a guarded HEAD probe reached (or failed to reach) the target; the dialed IP is SSRF-validated, so private/rebinding targets are refused. Any HTTP response counts as runnable.","tool":"curl","checks":{"schemeOk":true,"tlsValid":true,"urlValid":true,"hasTarget":true,"reachable":true,"httpStatus":200,"dnsResolves":true,"hostPresent":true,"methodValid":true,"privateTarget":false},"method":"GET","reason":null,"source":{"url":"https://2s.io/dev/preflight","license":"No upstream license — computed by 2s.io (optional live HEAD probe of the supplied target).","provider":"2s.io command preflight"},"command":"curl -sSL https://api.github.com/users/octocat","targets":["https://api.github.com/users/octocat"],"verdict":"runnable","runnable":true}],"total":1,"source":{"url":"https://2s.io/dev/preflight","license":"No upstream license — computed by 2s.io (optional live HEAD probe of the supplied target).","provider":"2s.io command preflight"}},"meta":{"cost":{"usd":0.001,"tier":0},"caller":"x402","version":null,"endpoint":"dev.preflight","settlement":{"txHash":"0x34d43a1e5c692b88f7a807194ffe4d556177a52f1c0028331ac83233d89114be","network":"eip155:8453","success":true}}}},"exampleRequest":{"probe":true,"command":"curl -sSL https://api.github.com/users/octocat"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2MR9oc8ytcfhjFQ83N95V","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates and preflights a shell command string by checking the target URLs it contains for reachability, TLS, DNS, HTTP method validity, and runnability.","exampleAgentPrompt":"Before I run this command, can you preflight it and tell me if the URL is actually reachable, TLS is valid, and it's safe to execute: curl -sSL https://api.github.com/users/octocat — also do a live HEAD probe.","exampleUseCases":null,"resultDescription":"Returns a structured JSON object with a verdict ('runnable' or otherwise), per-check boolean results (schemeOk, urlValid, hostPresent, methodValid, privateTarget, tlsValid, dnsResolves, reachable, httpStatus), the parsed target URLs, the detected tool, the mode (static/live), and a reason if not runnable. Also includes total count and source/provider metadata.","failureModes":["Invalid or unparseable command string returns a non-runnable verdict with a reason field","Target URL resolves to a private IP range — flagged as privateTarget: true","DNS does not resolve — dnsResolves: false","TLS certificate invalid — tlsValid: false","HTTP probe returns non-2xx status when live probe is enabled","Missing required 'command' field returns an error or empty items array"],"whenToPreferThis":"Use this endpoint when an AI agent needs to validate a shell command (especially curl/wget) before executing it, confirm target URL reachability, or check for security red flags like private-network targeting or invalid TLS. Prefer over generic URL checkers because it parses the full shell command syntax and understands tool-specific semantics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:46:40.851Z","isFirstParty":false,"canonicalSlug":"2s-io-dev-preflight-command-url-validator-88dbbf96"}