{"uid":"cap_A-RYp09J-D7PU38yxeHXz","slug":"agent402-tools-api-investigation-8af363c1","name":"agent402.tools API Investigation","description":"Bundled execution of the API investigation workflow - Point at an unknown API endpoint and figure out how to use it: auth scheme, content type, version, rate limits, OpenAPI/Swagger spec discovery, and JSON response structure. The deterministic recon workflow before writing a single line of integration code. One x402 payment runs 7 underlying tools (url-parse, http-check, http-headers, extract, html-links, json-format, json-query); partial-success per step.","url":"https://agent402.tools/api/skill/api-investigation","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"endpoint":{"type":"string","description":"API URL to investigate (e.g. https://api.example.com/v1/users)"}}},"responseSchema":{"type":"json","example":{"args":{"endpoint":"https://agent402.tools/api/pricing"},"pack":"api-investigation","steps":[{"ok":true,"slug":"url-parse","result":{}},{"ok":true,"slug":"http-check","result":{}},{"ok":true,"slug":"http-headers","result":{}},{"ok":true,"slug":"extract","result":{}},{"ok":true,"slug":"html-links","result":{}},{"ok":true,"slug":"json-format","result":{}},{"ok":true,"slug":"json-query","result":{}}],"summary":"7/7 steps succeeded"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.017","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.017/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.017","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.017","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_89WcNum03gjP_Lb0GotHr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.017","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Investigates an unknown API endpoint to discover its auth scheme, content type, versioning, rate limits, OpenAPI/Swagger spec, and JSON response structure","exampleAgentPrompt":"I found this API endpoint at https://api.someservice.com/v1/users but I have no idea how to use it — can you investigate it and tell me what auth method it uses, whether it has an OpenAPI spec, its rate limits, and what the JSON response looks like?","exampleUseCases":null,"resultDescription":"A structured report covering the detected authentication scheme (e.g. Bearer, API key, Basic), content type, API version, rate limit headers, any discovered OpenAPI/Swagger spec URL, and an annotated sample of the JSON response structure returned by the endpoint.","failureModes":["Target URL is unreachable or returns a network error — investigation cannot proceed","Target endpoint returns an HTML page (e.g. landing page) rather than an API response — limited useful metadata extractable","Rate limits or IP blocks on the target API prevent probing — partial results only","Target API requires mandatory auth before returning any response — auth scheme may be inferred but response structure unavailable","Malformed or non-standard OpenAPI specs may not be detected","Non-JSON response bodies limit response structure analysis"],"whenToPreferThis":"Use this endpoint when you have a URL for an unfamiliar or undocumented API and need to quickly understand how to integrate with it — especially when you want to avoid manual trial-and-error exploration. Prefer this over generic HTTP inspection tools when you need a bundled, structured output covering auth, versioning, rate limits, and schema discovery in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:14:04.383Z","isFirstParty":false}