SnozeDevelopers
API referenceItem access

Resolve a shared item and the caller's access to it

Given an item id — or the id of the underlying resource, which is what deep links carry — returns the owning workspace, its name, the item summary, and the caller's effective access level, so the client can route a bare link to the right workspace. Requires an authenticated caller with at least `view` on the item. Archived items and ids that match nothing are not found.

GET
/v1/me/shared-items/{itemId}

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

itemId*string

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X GET 'https://api.snoze.dev/v1/me/shared-items/string'
Example Response
{  "data": {    "workspaceId": "string",    "workspaceName": "string",    "workspaceImageUrl": "string",    "accessLevel": "view",    "item": {      "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"    },    "publicFile": {      "type": "file",      "meta": {        "kind": "folder",        "title": "string",        "icon": "string",        "color": "string",        "allowDownload": true,        "accessLevel": "view",        "workspaceName": "string"      },      "name": "string",      "mimeType": "string",      "byteSize": 0,      "url": "string"    }  }}

Replace the caller's native widget configuration

Overwrites the caller's widget configuration for this workspace and returns the normalized result (unknown shortcuts dropped, an incomplete metric cleared, charts deduplicated by id and capped at six). This is a full replacement rather than a patch, so sending the same configuration twice is a no-op. Storing it server-side is what lets the worker send a silent refresh push without the app running. Requires `workspace:read`; send an `Idempotency-Key` header to make retries safe.

Read the access list for an item

Returns the item's direct and inherited grants across its folder ancestry, pending guest invites, whether an active share link exists, the nearest ancestor that restricts inheritance, and what the caller themselves may change. Requires at least `view` on the item, and an API key additionally needs the `resources:read` scope. An unknown or malformed item id is not found.