Grava Docs

Enqueue a dataset run

POST/v1/datasets/{datasetId}/runs

Durably enqueues a manual run. No credit is charged until all checks pass. A failed check writes no rows and costs nothing.

AuthorizationBearer <token>

API key shown once at creation and stored as a SHA-256 hash.

In: header

Path Parameters

datasetId*string

Dataset UUID.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/datasets/497f6eca-6276-4993-bfeb-53cbbbba6f08/runs"
{  "runId": "8dca4e89-2667-46aa-9913-148984e3ed1d",  "creditsRemaining": 1000}