{"uid":"cap_TgNJtrezuiJf4HHaSH-th","slug":"relayshield-scan-file-check-77916d34","name":"RelayShield Scan File Check","description":"Scan a file (via its public download URL) for malware using VirusTotal's multi-engine analysis. Returns an async analysis ID to poll. Call before an agent downloads, opens, or executes a file attachment from an untrusted source.","url":"https://atq6wtkp6k.execute-api.us-east-1.amazonaws.com/prod/v1/payg/scan-file","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"file_url":{"type":"string","description":"Publicly accessible download URL"},"filename":{"type":"string","description":"Optional filename hint for AV engines"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_683KgCuzWsfGgpx3rEN4m","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submits a file URL for asynchronous security scanning and returns an analysis ID to poll for results","exampleAgentPrompt":"Can you run a RelayShield security scan on this file before I open it — it's at https://cdn.example.com/invoice.pdf and the filename is invoice.pdf?","exampleUseCases":null,"resultDescription":"Returns a pending status with an analysis_id and a poll_endpoint path (e.g. /v1/result/f-abc123def456) that the agent should poll every 5 seconds until the scan status changes to completed.","failureModes":["Invalid or unreachable file URL returns an error","Unsupported file type may result in failed analysis","Network timeout if the file is too large or slow to fetch","Missing required fields (target URL or filename) returns validation error","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need to asynchronously scan a file hosted at a URL for security threats such as malware or malicious content, especially PDFs, documents, or other downloadable assets. Prefer this over URL-only scanning when the input is a concrete file rather than a web page, and when you can tolerate a polling-based async workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:50:04.146Z","isFirstParty":false}