List recent sync runs in a workspace
Returns the workspace's most recent integration sync runs with their status and statistics. Requires the `integrations:read` workspace permission. Pass `connectionId` to restrict the list to one connection and `limit` to cap how many runs come back.
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/integrations/sync-runs"{ "data": [ { "id": "string", "workspaceId": "string", "connectionId": "string", "dataSourceId": "string", "provider": "string", "status": "running", "trigger": "string", "cursorBefore": "string", "cursorAfter": "string", "stats": {}, "error": "string", "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 named provider migration for a connection
Runs a migration registered for the connection's provider as a bounded series of syncs, and reports whether it completed or stopped partway with the objects imported so far, the guarantees the migration preserves, and any warnings; a partial result means the run should be repeated to continue. Requires the `integrations:write` workspace permission, and is rejected as invalid when the migration key is not registered for the provider or the provider has no adapter. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.
Browse the remote resources of a connection
Lists one level of a provider's resource tree through the connection, optionally under `parentExternalId`, filtered by `externalType`, or matched against `query`. Requires the `integrations:read` workspace permission and the provider feature enabled for the workspace; a provider whose adapter cannot browse is rejected as invalid. Paginated: pass `limit` (capped at 100) and the `cursor` from the previous response. Results are served from a short-lived encrypted mirror, so a listing may be up to a few minutes stale while it refreshes.