SnozeDevelopers
API referenceIntegrations

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.

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

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
placementKind?|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/link' \  -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"    }  }}

Remove a linked or mounted resource placement

Detaches a placement from the workspace and returns the deleted id, leaving the resource untouched at the provider. 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.

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.