Data

Run a data tool

Runs one data tool (find it with listDataTools) with input matching its input_schema, and returns the source's data. Billed from what the source charged, usually 1-5 credits; a failed run is free. Tools marked queued wait on the source's queue: if one is not done within about 25 seconds the run comes back running (HTTP 202), so poll getDataRun until it is succeeded or failed.

post/data/runs

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/data/runs
  • Auth: API key in header Authorization

Headers

Idempotency-Keystring

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Request body

tool_idstring required

Tool id from listDataTools, e.g. smb.search.

inputobject

The tool's input, per its input_schema.

Response

Finished run (succeeded or failed).

objectstring required
idstring required
tool_idstring required
statusstring required
dataobject nullable required
sourcestring nullable required
errorobject nullable required
credits_usedinteger required
inputobject required
created_atstring required
completed_atstring nullable required

Changes

No recorded changes to this operation across all 2 revisions of this API.