Permission Set for C4 Diagram Sets
Use role-based permissions to control how users interact with C4 Diagram Sets in Nodinite. A C4 Diagram Set holds the Architecture Diagrams for one software system, so the Role decides who can create new sets, who can open a set, and who can change it.

Animated walkthrough: give a Role Access and Modify on one Diagram Set, with no Modify in Global permissions, then, as a member of the Role, edit that set. The member sees Edit but no New Diagram, which needs Create. The Role also holds the Repository rights a C4 diagram needs.
Understanding the Permission Model
The permission set has two scopes. Global permissions apply to every C4 Diagram Set and hold the only Create right. Per-set assignments grant Access or Modify on individual sets.
Tip
To let a Role edit one set only, give it per-set Modify on that set. A member then gets Edit on that set's page, and can update, delete, and restore it through the Web API. Global Modify instead lets a member change every set the Role has Access to. A Deny on either scope wins. The With Selected batch actions on the Diagram Sets and All Diagrams lists, and Component Types, need global Modify.
C4 Diagram Sets row"] Role --> PerSet["fa:fa-sitemap Per-set assignments
C4 Set Permissions"] Role --> Logging["fa:fa-waveform-lines Logging
global"] Global --> GA["fa:fa-lock Access"] Global --> GC["fa:fa-file-plus Create
Create C4 Diagram Sets"] Global --> GM["fa:fa-file-pen Modify"] PerSet --> SA["fa:fa-lock Access"] PerSet --> SM["fa:fa-file-pen Modify"] style Global fill:#2678BD,color:#fff style PerSet fill:#3F827B,color:#fff style GC fill:#E47528,color:#fff
Blue = global permissions, teal = per-set assignments, orange = the Create right, which exists only at global scope.
Permissions in the Set
| Permission | Global (C4 Diagram Sets row) | Per assigned set | What it unlocks |
|---|---|---|---|
| Access | ✅ Yes | ✅ Yes | Open and view the set and its diagrams. The set-level value can inherit from the global value. |
| Create (Create C4 Diagram Sets) | ✅ Yes | ❌ No | Create new C4 Diagram Sets, and Import diagrams: the Import button only appears for users with this right, and the import apply step on the server requires it too. New 7.12 Every new Draft needs it too: Clone as Draft, the next layer, Create Container Draft and Create Component Draft in the designer, and the assistance panel's Create Draft to apply. |
| Modify | ✅ Yes | ✅ Yes | Change existing sets and their diagrams, and New 7.12 Delete, Restore, and Permanently Delete sets and diagrams, live or deleted. C4 is user content, so no Administrator Role is needed (see Two delete models). |
| Logging (own row, Access column) | ✅ Yes | ❌ No | Use grouped-log dynamic diagram entry points (Inspect Grouped Log Views as Runtime Diagrams). |
The values follow the standard Nodinite model: Inherited, Allow, or Deny, where a Deny always wins (see Permission Set for the Repository Model).
Repository Rights C4 Also Needs
New 7.12 A C4 diagram shows and changes Repository items, so the C4 Diagram Set rights alone aren't enough. The user's Role also needs these rights in the Permission Set for the Repository Model:
| To | Also needs, besides the C4 Diagram Set right |
|---|---|
| Open, view, or export a diagram, and the grouped Log View's runtime diagram | Access on Systems, Services, Integrations, Message Types, Endpoints, and Domains, plus Contracts when Contracts are on |
| Design: save in the Designer, delete diagrams, next layer, Generate from Integration Landscape, C4 Dynamic on the BPM page, clone, promote | The read rights above, plus Create and Modify on Systems, Services, Integrations, and Domains (plus Contracts) |
| Import diagrams | The design rights above, plus Create on Systems, Services, and Domains. Import is refused before the wizard opens |
Without the read rights, opening a diagram answers 403 Forbidden with C4 needs more Repository rights and one line per missing right. The Diagram Sets list and the sidebar still load. A design or import click without its rights answers with the same message, naming the missing read and create rights. Generate and C4 Dynamic check their rights before they make a new set.

Animated walkthrough: a Role with read access to Systems only. The set still opens; Import and the diagram each name the Repository rights that are missing. An administrator adds them to the user's Role, and then the diagram opens.

The Import refusal lists the missing read rights and the missing create rights.
Where to Find the Create Right
Create is a global right only, because a set that doesn't exist yet can't be assigned to a Role:
- Open the Role in the Role editor (Add or manage Role).
- Select the C4 Set Permissions (x) tab and find Global permissions.
- In the C4 Diagram Sets row, set the Create column, next to Access and Modify. The Logging right is the row below it, with only an Access column.

The C4 Set Permissions (1) tab of the Contoso: Architecture Readers Role, right after Save: Access, Create, and Modify on the C4 Diagram Sets row and Access on the Logging row under Global permissions; below, the assigned sets with Access and Modify, and Edit to change them.
The per-set list, and the assignment modal behind Edit, has only Access and Modify. Looking for Create there is the most common reason administrators believe the right is missing.
For API and audit work, the rights use these permission object types:
| Right | Permission object type |
|---|---|
| Access C4 Diagram Sets | 550 |
| Create C4 Diagram Sets | 5600 |
| Modify C4 Diagram Sets | 5601 |
Recommended Permission Strategy
- Grant Access to architecture consumers.
- Grant Modify to the architects and maintainers who keep the diagrams current. To limit them to some sets, give Modify per set instead of globally (see the tip above).
- Grant Create only to the few Roles that set up new Diagram Sets or Import diagrams.
- Grant Logging to users who need grouped-log dynamic diagram capabilities.
- Review assignments regularly so only required Roles have Create and Logging enabled.
Role Assignments
In the Role editor, administrators use C4 Set Permissions (x) to manage set assignments and permission values:
- The value x shows the number of assigned C4 Diagram Sets.
- Use the Edit flow to add or remove C4 Diagram Sets from the Role: tick the sets, open Selected, set Access and Modify for each, Confirm and close, then Save. Values set on a set ticked in the same visit are saved.
- Configure Create and Logging at global scope.
The DefaultRolesInViews System Parameter pre-selects Roles on every new C4 Diagram Set New 7.6; you still set their Access and Modify values here.
Logging and Grouped-Log Dynamic Diagrams
When Logging is not allowed for a user's Role, grouped-log dynamic diagram entry points are hidden for that user. Grant Logging only to Roles that should use this capability.