SnozeDevelopers
API referenceIntegrations

Materialize one level of a mounted folder's children

Expands a mounted provider folder by creating native workspace items for one level of its provider children and archiving children that have disappeared upstream, then drops the workspace's cached provider content so later reads are fresh. Requires the `integrations:read`, `integrations:write`, `resources:read`, and `resources:write` workspace permissions because the refresh reads provider content and mutates workspace items. Naturally idempotent per child: re-running is the refresh path rather than a duplicate import.

POST
/v1/workspaces/{workspaceId}/integrations/items/{itemId}/sync-children

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
itemId*string

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X POST 'https://api.snoze.dev/v1/workspaces/string/integrations/items/string/sync-children'
Example Response
{  "data": {    "items": [      {        "id": "0b6f2e6a-9f2c-4e7a-8d31-2c1e7a9f2c4e",        "workspaceId": "4b81aa0c-6d2f-4b19-9f0e-1a7c3d5e8b02",        "parentItemId": "d3a7f1b8-5c04-4e62-9a11-7b2e6c0d4f39",        "kind": "database",        "targetId": "9f2c1e7a-3b58-4d0c-8e27-6a1f9d4b3c85",        "title": "Launch tasks",        "icon": "rocket",        "color": "#2f6f4f",        "order": 0,        "archived": false,        "accessMode": "open",        "metadata": {},        "createdAt": "2026-07-01T09:12:44.000Z",        "updatedAt": "2026-07-14T16:03:10.000Z"      }    ]  }}

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.

List the external resources linked into a workspace

Returns the provider resources that have been linked or mounted into the workspace. Requires both the `resources:read` and `integrations:read` workspace permissions.