Running tools
All tools work the same way: POST /v1/tools/{slug}/runs with an Idempotency-Key header. The call waits for the result.
| Status | Meaning |
|---|---|
201 | The run finished, the result is in data. Credits were charged |
200 | Same run returned again, or dry_run. Nothing was charged |
402 | Not enough credits, or a daily cap was reached |
409 | A run on the same target is in progress, try again shortly |
422 | The address cannot be scanned, or an input is wrong |
If a run fails before it produces a result, no credits are charged. Addresses on private networks and on our own domains are refused.
Earlier runs stay available through GET /v1/runs and GET /v1/runs/{run_id}.