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.
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
shortcuts*array<>page?|null|nullmetric?|null|nullcharts?array<|>|nullSuccess
application/json- response
data*curl -X PUT 'https://api.snoze.dev/v1/workspaces/string/widgets/settings' \ -H 'Content-Type: application/json' \ -d '{ "shortcuts": [ "home" ]}'{ "data": { "shortcuts": [ "home" ], "page": { "itemId": "string", "title": "string", "kind": "string" }, "metric": { "databaseId": "string", "databaseLabel": "string", "aggregate": "count", "fieldKey": "string", "fieldLabel": "string", "label": "string", "display": "number", "groupByFieldKey": "string", "groupByFieldLabel": "string", "chartColor": "string" }, "charts": [ { "id": "string", "kind": "dashboard", "itemId": "string", "blockId": "string", "title": "string", "dashboardTitle": "string" } ] }}Read the caller's native widget configuration
Returns the caller's configured shortcuts, pinned page, metric and home-screen charts for this workspace. Requires `workspace:read`. Always the caller's own row; there is no way to read another member's widget configuration.
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.