Read a provider resource by reference
Fetches the content of a provider resource identified by an external reference rather than a linked resource id, so a browsed item can be previewed before it is linked or imported. Requires both the `resources:read` and `integrations:read` workspace permissions, checked live, and applies the same per-caller access rule as reading a linked resource (`resource_access_denied` when the caller cannot reach it through the install or a connected account of their own), with the same credential-scoped content mirror.
apiKeyAuthorizationBearer <snoze_sk_…>Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
workspaceId*stringapplication/json- body
connectionId*stringresource*Success
application/json- response
data*curl -X POST 'https://api.snoze.dev/v1/workspaces/string/integrations/resources/read' \ -H 'Content-Type: application/json' \ -d '{ "connectionId": "string", "resource": { "externalType": "string", "externalId": "string", "name": "string", "surfaceKind": "generic", "capabilities": [ "browse" ] }}'{ "data": { "format": "json", "content": null, "revision": "string", "readOnly": true, "fallbackUrl": "string" }}Read the content of a linked external resource
Fetches a linked resource's current content from its provider and returns it in the format the provider exposes, along with its revision, whether it is read-only, and a fallback URL when Snoze cannot render it. Requires the `resources:read` workspace permission, re-checked on every request. Content is read as the caller: a resource on a workspace-shared install is readable by any member, while one linked through a teammate's personal OAuth account is readable only by that teammate or by a caller whose own connected account can reach it — anyone else receives `resource_access_denied` (403) before any provider call. Content is served from a short-lived encrypted mirror scoped to the credential used, so a response may be up to a few minutes stale while it refreshes.
Read the resource behind a placement
Returns the placement together with the external resource it points at, which is how a workspace item resolves back to its provider origin. Requires both the `resources:read` and `integrations:read` workspace permissions; an unknown placement is reported as not found.