{"uid":"cap_u4xNoxb5QJ0CJp8nAwdr9","slug":"relayshield-file-scan-c41314d8","name":"RelayShield File Scan","description":"RelayShield Landing Site","url":"https://api.relayshield.net/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":{"type":"json","example":{"ok":true,"data":{"note":"Poll /v1/result/{analysis_id} every 5s until status is completed","status":"pending","target":"https://cdn.example.com/invoice.pdf","filename":"invoice.pdf","analysis_id":"f-abc123def456","poll_endpoint":"/v1/result/f-abc123def456"}}},"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_yqKX2iLFqH_9yEsLTGx7B","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 scan this file for me before I open it? The URL is https://cdn.example.com/invoice.pdf — I want to make sure it's safe and not malicious.","exampleUseCases":[{"title":"Scan invoice PDF before payment","prompt":"I just received an invoice PDF from a vendor at https://files.vendor.com/invoice-2024.pdf — can you scan it for malware or anything suspicious before I download it?"},{"title":"Verify contractor document safety","prompt":"A contractor sent me a file at https://storage.example.com/contract_draft.docx — please run a security scan on it and let me know if it's safe to open."},{"title":"Check CDN asset before deployment","prompt":"Before I deploy this asset to production, can you scan https://cdn.myapp.com/setup-script.zip for any threats or malicious content?"}],"resultDescription":"Returns a JSON object with an analysis_id, initial status ('pending'), the target URL, filename, and a poll_endpoint path. The agent must poll /v1/result/{analysis_id} every 5 seconds until the status changes to 'completed' to retrieve the full scan results.","failureModes":["Invalid or unreachable file URL returns an error response","File too large or unsupported format may be rejected","Payment failure (x402) prevents scan from being initiated","Poll endpoint may return 'pending' for extended periods for large files","Analysis ID not found if polling too early or after expiration"],"whenToPreferThis":"Use this endpoint when you need to asynchronously scan a remotely hosted file (via URL) for security threats before processing, storing, or sharing it. It is particularly suited for agent workflows that receive untrusted file URLs (e.g. from email attachments, vendor uploads, or CDN links) and need a lightweight pay-per-scan model via USDC micropayment (x402 protocol) without a subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:50:44.738Z","isFirstParty":false}