SnozeDevelopers
API referenceIntegrations

Mount a provider resource into the workspace

Creates a mount for a browsed provider resource so its content is mirrored into the workspace rather than merely linked, optionally recursively and under `parentItemId`, and returns the resource with its placement and mount. Requires both the `resources:write` and `integrations:write` workspace permissions. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.

POST
/v1/workspaces/{workspaceId}/integrations/resources/mount

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

Request Body

application/json
  1. body
connectionId*string
resource*
parentItemId?string|null
title?string|null
mode?|null
recursive?boolean|null
clientMutationId?string|null

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X POST 'https://api.snoze.dev/v1/workspaces/string/integrations/resources/mount' \  -H 'Content-Type: application/json' \  -d '{  "connectionId": "string",  "resource": {    "externalType": "string",    "externalId": "string",    "name": "string",    "surfaceKind": "generic",    "capabilities": [      "browse"    ]  }}'
Example Response
{  "data": {    "resource": {      "id": "string",      "workspaceId": "string",      "connectionId": "string",      "provider": "string",      "externalType": "string",      "externalId": "string",      "name": "string",      "surfaceKind": "generic",      "ownership": "external",      "capabilities": [        "browse"      ],      "mimeType": "string",      "canonicalUrl": "string",      "parentExternalId": "string",      "revision": "string",      "providerCreatedAt": "string",      "providerModifiedAt": "string",      "metadata": {},      "syncStatus": "current",      "lastSyncedAt": "string",      "createdAt": "string",      "updatedAt": "string"    },    "placement": {      "id": "string",      "workspaceId": "string",      "resourceId": "string",      "workspaceItemId": "string",      "mountId": "string",      "kind": "link",      "refId": "string",      "displayName": "string",      "createdAt": "string",      "updatedAt": "string"    },    "mount": {      "id": "string",      "workspaceId": "string",      "connectionId": "string",      "provider": "string",      "rootResourceId": "string",      "rootPlacementId": "string",      "mode": "live",      "recursive": true,      "enabled": true,      "cursor": "string",      "lastSyncedAt": "string",      "createdAt": "string",      "updatedAt": "string"    }  }}

Link a provider resource into the workspace

Creates a link or shortcut item in the workspace pointing at a browsed provider resource, optionally under `parentItemId` and with a custom title, and returns the resource with its new placement. Requires both the `resources:write` and `integrations:write` workspace permissions. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.

Import a Google Form as a native form and database

Copies a Google Form into a new native Snoze form plus a purpose-built backing database for its responses, and reports the questions that had no native equivalent. This is a one-time structural copy with no ongoing link to the provider. Requires the provider read permissions the underlying resource read enforces, plus permission to create the form and database. A resource that is not a Google Form, or a form with no importable questions, is rejected. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.