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.
apiKeyAuthorizationBearer <snoze_sk_…>Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
workspaceId*stringSuccess
application/json- response
data*curl -X GET 'https://api.snoze.dev/v1/workspaces/string/widgets/settings'{ "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 snapshot
Returns everything the caller's home-screen widgets render in one payload: shortcut counts, the Today digest (Needs approval, Automation failures, Waiting on you, Recent activity — at most five rows each), the newest unread inbox rows, the configured database metric with its chart points, the pinned page, and every configured chart evaluated by the dashboard engine and reduced to render-ready rows. Computed from the caller's stored widget settings, so a widget extension needs no other call. Requires `workspace:read`; sections the caller cannot see (automation failures without `automations:read`) are omitted rather than refused, a metric whose database was deleted degrades to null, and a chart whose dashboard or database is gone or unreadable stays in the list with `empty` set, so the other widgets still refresh.
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.