SnozeDevelopers
API referenceIntegrations

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.

GET
/v1/workspaces/{workspaceId}/integrations/sync-runs

Authorization

apiKey
headerAuthorizationBearer <snoze_sk_…>

Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.

Path Parameters

workspaceId*string

Query Parameters

limit?string|null
connectionId?string|null

Response Body

Success

application/json
  1. response
data*array<>
Example Request
curl -X GET 'https://api.snoze.dev/v1/workspaces/string/integrations/sync-runs'
Example Response
{  "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"    }  ]}

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.