List the provider operations available in a workspace
Returns the operations the workspace's providers expose, including which ones mutate the third-party system and which require explicit confirmation. Requires the `integrations:read` workspace permission.
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
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/workspaces/string/integrations/operations"{ "data": [ { "provider": "string", "operation": "string", "label": "string", "description": "string", "resourceTypes": [ "string" ], "inputFields": [ { "key": "string", "label": "string", "kind": "string", "required": true, "resourceType": "string", "dependsOn": "string", "options": [ { "value": "string", "label": "string", "description": "string" } ], "multiple": true, "advanced": true, "role": "body", "composerGroup": "message", "defaultTriggerPath": [ "string" ], "description": "string", "placeholder": "string" } ], "textSyntax": "markdown", "outputShape": { "label": "string", "fields": [ { "key": "string", "label": "string", "kind": "text", "shape": {}, "description": "string" } ] }, "mutates": true, "requiresConfirmation": true, "affects": "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}Import a provider resource as a native database or page
Copies one browsed provider item into native Snoze content — a Notion database becomes a database with its records, a Notion page or a ClickUp list or a Jira project becomes the matching native surface — and reports the structures that had no native equivalent. The result is fully editable and not live-linked; re-importing the same resource refreshes it in place because records key on the provider's external id. Requires the provider read permissions the underlying resource read enforces, plus permission to create the resulting content; other resource types are rejected as unsupported. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.
Run a provider operation through a connection
Executes one registered provider operation against a connection, targeting either a linked resource or an external reference, and returns the run with its status and output. Requires the `integrations:read` workspace permission, and additionally `integrations:write` when the operation mutates the provider; operations marked as requiring confirmation are refused unless the body sets `confirmed`. An unregistered operation is rejected with the provider's registered operation ids named. After a successful run the workspace's cached provider content is dropped and a connector refresh is attempted so native mirrors catch up. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.