Personal overlay
Every member has a private overlay on top of the shared Blueprint. Console writes the Blueprint. The organization collection writes only that person's overlay — including when the person is an admin.
What the overlay may change
- Rename a Blueprint folder or bookmark, change its note, icon, or color.
- Reorder tiles and change wallpaper, theme, or start page for that person only.
- Add personal folders and links (
origin: personal). - Pin a Blueprint item under a different parent so a later Blueprint move does not follow.
Overlay objects keep an origin: blueprint for Admin items the member restyled, personal for items they created. Personal folders may sit inside a Blueprint folder.
What the overlay cannot do
- It cannot reveal a Blueprint item the member's roles hide. Filtering happens first.
- It cannot edit the shared Blueprint. That happens only in Console → Blueprint.
- It cannot share a Blueprint folder or bookmark. Only personal items can be shared with other members.
- Search and the consume API never return hidden Blueprint items through the overlay.
When Admin changes the Blueprint
- New Blueprint objects appear under the same stable folder ID for every member, appended at the end — even if that member renamed the folder.
- If Admin deletes a Blueprint folder, personal children move to the next living Blueprint ancestor or the collection root.
- If Admin moves a Blueprint item, members follow unless they pinned their own parent.
Restore
Restore logo, color, title, and description on a Blueprint bookmark. On a folder, the same fields reset for that folder and every Blueprint descendant. Personal children stay. Restoring the collection root also resets wallpaper, theme, and view to Blueprint defaults.
POST /api/org/:slug/restore
{ "scope": "bookmark" | "folder" | "collection", "id": "bm_…" }
PATCH /api/org/:slug/collection
stores only this member's overlayBlueprint, restore, and internal sharing are also covered in Blueprint. Visibility rules live in Roles and visibility.