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).
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
Query Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/workspaces/string/data-sources/string/runs"{ "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}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.
List the workspace's connections
Returns the workspace's stored connections newest first, plus the enabled provider installs that also act as connector credentials, with the names of each secret's entries but never their values. Requires the `data_sources:read` permission. Disabled installs are omitted so a step is never offered a credential the operator switched off.