Run a data source sync now
Claims the data source and runs a sync immediately outside its schedule, returning the resulting run record. Requires `data_sources:write` and edit access to the data source's item. A disabled source, or one refreshed moments ago and not in an error state, is rejected as a validation error by the manual-run cooldown. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Path Parameters
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/workspaces/string/data-sources/string/refresh"{ "data": { "id": "string", "workspaceId": "string", "dataSourceId": "string", "status": "running", "trigger": "manual", "actorUserId": "string", "stats": { "rowsFetched": 0, "rowsInserted": 0, "rowsUpdated": 0, "rowsUnchanged": 0, "rowsRemoved": 0, "rowsSkipped": 0, "bytesFetched": 0, "durationMs": 0 }, "error": "string", "errorKind": "fetch", "startedAt": "string", "completedAt": "string" }}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Preview what deleting a data source would affect
Returns the dependency impact report for the data source, separating blocking dependents from warnings. Requires read access to the data source. Use it before `delete` to decide whether the confirmation flag is needed.
List a data source's sync runs
Returns the most recent sync runs for the data source, newest first, with their trigger, status, timing, and row statistics. Requires `data_sources:read` and view access to the data source's item. Pass `limit` to change the page size (default 30, maximum 100).