{"uid":"cap_02YIGnwaqxleCRm4fjXGb","slug":"url-port-policy-check-3de55427","name":"URL Port Policy Check","description":"URL Port Policy Check: URL Port Policy Check checks a URL effective port against a caller allowlist from bounded caller-supplied values without an external provider. Call URL Port Policy Check before accepting, caching, redirecting, or retrying a caller-supplied web response. Returns normalized web evidence, the computed finding, and an explicit pass or advisory status for URL Port Policy Check as versioned deterministic JSON. Price: $0.001 USDC via x402 on Base. First-party, stateless, memory-…","url":"https://api.delx.ai/api/v1/x402/url-port-policy-check","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","maxLength":8192,"description":"URL supplied to URL Port Policy Check; used only for this bounded calculation and processed in memory without retention."},"allowed_ports":{"type":"array","items":{"type":"integer"},"maxItems":256,"description":"Allowed Ports supplied to URL Port Policy Check; used only for this bounded calculation and processed in memory without retention."}}},"responseSchema":{"type":"json","example":{"result":{"allowed":true,"effective_port":8443},"schema":"delx/util-url-port-policy-check/v1","status":"pass","evidence":{"retained":false,"input_sha256":"3c3ea04a21ed18c950af0adf058569fc48c74f8beaa16d9066f239014d36a638","external_calls":0},"operation":"web_reliability:url_port_policy_check"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6RkgoFgTjAuAuCRZo_X3L","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates a URL's effective port against a caller-supplied allowlist and returns a deterministic pass/advisory verdict as versioned JSON","exampleAgentPrompt":"Before I cache this response, check whether the URL 'http://example.com:8080/path' has a port that's on my allowlist of [80, 443, 8080] and tell me if it passes policy.","exampleUseCases":[{"title":"Block non-standard ports in agent pipeline","prompt":"I'm about to follow a redirect to 'http://internal.service.com:9000/data' — can you check whether port 9000 is allowed given my allowlist of [80, 443] and tell me if I should proceed?"},{"title":"Validate user-submitted webhook URL port","prompt":"A user submitted the webhook URL 'https://myapp.io:8443/webhook' — check if that port is on my approved list of [443, 8443] before I save it to the database."},{"title":"Enforce port policy before retrying failed request","prompt":"I need to retry a failed request to 'http://api.partner.com:3000/v1/status' — first check if port 3000 is in my allowed ports [80, 443, 3000, 8080] and give me a pass or advisory verdict."}],"resultDescription":"Returns a versioned deterministic JSON object containing: the normalized URL evidence (extracted port info), the computed policy finding, and an explicit pass or advisory status indicating whether the URL's effective port is within the caller-supplied allowlist.","failureModes":["URL is malformed or unparseable — endpoint may return an error or advisory status","allowed_ports array exceeds 256 items — rejected per schema constraints","URL string exceeds 8192 characters — rejected per schema constraints","URL has no explicit port and default port inference may vary","Non-integer values in allowed_ports array cause validation errors"],"whenToPreferThis":"Use this endpoint when you need a stateless, deterministic, first-party port policy check on a caller-supplied URL without building your own parsing logic. Ideal before accepting, caching, redirecting, or retrying any external URL in an agent pipeline where port enforcement is a security requirement. Prefer this over general URL validation endpoints when port allowlisting is specifically needed, and over custom code when you want versioned, auditable JSON output with explicit pass/advisory verdicts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:30:22.520Z","isFirstParty":false}