{"uid":"cap_gkKAdEegvNHYqjzruc1hH","slug":"task-relay-url-health-check-80602cdb","name":"Task Relay URL Health Check","description":"When a machine must decide whether to continue, defer, or reject work on one public HTTP or HTTPS URL, Task Relay performs a single bounded reachability observation (DNS, redirects, HTTP status, TLS validity, sampled content fingerprint, elapsed time) and returns a strict statused machine-readable result for automated gating. Single-shot observation only; not continuous monitoring and not page extraction.","url":"https://task-relay-production.up.railway.app/x402/url-health","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"Public HTTP or HTTPS URL for one bounded reachability observation (private/loopback/metadata targets rejected by implementation)"}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["task_id","task_status","result","error"],"properties":{"error":{"type":["string","null"]},"result":{"type":["object","null"],"properties":{"dns":{"type":"object"},"tls":{"type":"object"},"status":{"enum":["live","redirected","http_error","timeout","dns_error","tls_error","unknown"],"type":"string"},"timing":{"type":"object"},"content":{"type":"object"},"final_url":{"type":"string"},"checked_at":{"type":"string"},"http_status":{"type":["integer","null"]},"requested_url":{"type":"string"},"billable_units":{"type":"integer"},"redirect_chain":{"type":"array"},"redirect_count":{"type":"integer"}}},"task_id":{"type":"string"},"task_status":{"enum":["succeeded","failed"],"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_eetlK310F7eMKI4aSQE4t","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs a single bounded reachability observation on a public HTTP/HTTPS URL, returning DNS, redirect, HTTP status, TLS validity, content fingerprint, and timing data in a machine-readable result.","exampleAgentPrompt":"Before we kick off the ingestion pipeline, do a single reachability check on https://example.com/data-feed and tell me whether it's live, what HTTP status it returns, and if there are any redirects.","exampleUseCases":[{"title":"Gate pipeline before URL ingestion","prompt":"Before we start processing, check if https://partner-api.example.com/feed is actually reachable — I need to know the HTTP status, whether TLS is valid, and if it redirects anywhere, so we can decide whether to proceed."},{"title":"Validate user-submitted URL before storing","prompt":"A user just submitted https://mysite.example.org/report as a source link — can you quickly probe it to confirm it's live and returns a 200 before we save it to the database?"},{"title":"Pre-flight check before automated workflow","prompt":"Before triggering the nightly job, run a reachability observation on https://data.govsite.org/exports/latest.csv and tell me the DNS result, HTTP status, and how long it took to respond so I can decide whether to defer or proceed."}],"resultDescription":"Returns a JSON object with task_id and task_status (succeeded/failed), plus a result object containing: reachability status enum (live, redirected, http_error, timeout, dns_error, tls_error, unknown), HTTP status code, final URL after redirects, full redirect chain and count, DNS details, TLS validity details, content fingerprint, timing metrics, checked_at timestamp, requested URL, and billable_units. On failure, an error string is included.","failureModes":["Private, loopback, or cloud metadata URLs are rejected by implementation","DNS resolution failure returns status dns_error","TLS certificate issues return status tls_error","Connection timeout returns status timeout","Non-2xx HTTP responses return status http_error with the actual status code","Malformed or missing URL in request body returns an error","Service unavailability on Railway hosting may cause unexpected failures"],"whenToPreferThis":"Choose this endpoint when an automated agent or pipeline needs a single-shot, machine-readable go/no-go signal about a public URL before committing to downstream work. It is ideal for pre-flight gating — checking before ingestion, storage, or workflow trigger — rather than continuous uptime monitoring. Prefer it over generic HTTP probes when you need structured output covering DNS, TLS, redirects, timing, and content fingerprint in one bounded observation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:32:22.484Z","isFirstParty":false}