Project113

Permissions Reference

The platform uses a permission system where each permission is a checkbox you can toggle when creating roles, adding members, or configuring audiences. Permissions are organized into categories and displayed with descriptive labels.

Permission Resolution

When the platform checks if an action is allowed, it evaluates in this order:

  1. Owner — Repository owners automatically have full access.
  2. Individual permissions — Direct permission grants to a specific member.
  3. Role-based permissions — Permissions inherited from assigned roles.
  4. Group-based permissions — Permissions inherited from group membership.
  5. Audience permissions — Broad permissions based on public/member/anonymous/owner audience.
  6. Default: Deny — If no permission grants the action, it is denied.

Audience Types

Audiences set broad permissions based on who is accessing the repository:

  • Owner — The repository owner or account. Controls what the owner can do on their own resources.
  • Member — Any authenticated user who is a member of the repository.
  • Public — Any authenticated user on the platform, even if they are not a member.
  • Anonymous — Unauthenticated users visiting the platform.

Default Permissions

When a repository is created, these permissions are enabled by default:

  • Public audience: Read Repository and Read Ref.
  • Anonymous audience: No permissions enabled.

Repository

Core permissions for the repository itself.

PermissionDescription
Allow Child RepositoryAllows creating child repositories (forks / sub-repositories).
Read RepositoryAllows reading (pulling) from repository.
Write RepositoryAllows writing (pushing) to repository.
Delete RepositoryAllows deleting the repository.
Edit Repository SettingsAllows editing of repository settings.
Read Repository SettingsAllows reading of repository settings.
Private Repository EmailPrevents repository set emails from being read.

Ref

Control operations on branches, tags, and other Git refs.

PermissionDescription
Create RefAllow creating new branches or tags.
Read RefSet default read (pull) access for refs.
Write RefSet default write (push) access for refs.
Merge RefSet default merge refs permission.
Force Push RefSet default force push refs permission.
Delete RefSet default delete refs permission.

Ref Policies

Control who can manage branch protection rules.

PermissionDescription
Reading Ref PolicyAllows seeing ref protection policies.
Add Ref PolicyAllows adding ref protection policies.
Edit Ref PolicyAllows editing ref protection policies.
Delete Ref PolicyAllows deleting ref protection policies.

Change Requests

Control the change request (pull request) lifecycle.

PermissionDescription
Create Change RequestAllows creating new change requests to propose merging branches.
Read Change RequestAllows reading change requests.
Edit Change RequestAllows editing change requests.
Delete Change RequestAllows deleting change requests.
Close Change RequestAllows closing change requests without merging.
Merge Change RequestAllows merging change requests into the target branch.
Force Merge Change RequestAllows force merging change requests even when requirements are not met.
Approve Change RequestAllows approving change requests.
Review Change RequestAllows reviewing change requests.
Edit CR Approval SettingsAllows editing approval settings on change requests.

Items

Control the item (issue / ticket) lifecycle.

PermissionDescription
Create ItemAllows creating items.
Read ItemAllows reading items.
Edit ItemAllows editing items.
Delete ItemAllows deleting items.
Close ItemAllows closing items.
Pin ItemAllows pinning items so they appear first in the list.

Item Types

Control who can manage custom item types.

PermissionDescription
Create Item TypeAllows adding item types.
Edit Item TypeAllows editing item types.
Delete Item TypeAllows deleting item types.
Read Item TypesAllows seeing item types.

Item Assignees

Control who can manage assignees on items.

PermissionDescription
Add Item AssigneeAllows adding assignees to items.
Edit Item AssigneeAllows editing assignees on items.
Remove Item AssigneeAllows removing assignees from items.
Read Item AssigneesAllows seeing assignees on items.

Item Threads

Control who can manage discussion threads (comments and notes) on items.

PermissionDescription
Add Item ThreadAllows creating threads on items.
Edit Item ThreadAllows editing item thread messages.
Delete Item ThreadAllows deleting item threads or messages.
Read Item ThreadsAllows reading threads on items.

Item Notes

Control who can manage internal notes on items. Notes are a thread type (comment / note / automated) with their own permission channel, distinct from item.threads.

PermissionDescription
Add Item NoteAllows adding notes to items.
Edit Item NoteAllows editing notes on items.
Delete Item NoteAllows deleting notes on items.
Read Item NotesAllows seeing notes on items.

Item Dependencies

Control who can manage dependencies between items.

PermissionDescription
Add Item DependencyAllows adding item dependencies.
Read Item DependenciesAllows seeing item dependencies.
Remove Item DependencyAllows removing item dependencies.

Item Linking

Control linking items to branches, change requests, and duplicates.

PermissionDescription
Add CR LinkAllows linking a change request to an item.
Delete CR LinkAllows removing a change request link from an item.
Read CR LinksAllows seeing change request links on items.
Add Ref LinkAllows linking a branch (ref) to an item.
Delete Ref LinkAllows removing a branch link from an item.
Read Ref LinksAllows seeing branch links on items.
Add DuplicateAllows marking an item as a duplicate.
Delete DuplicateAllows removing a duplicate relationship.
Read DuplicatesAllows seeing duplicates on items.

Item Policies

Control who can manage automated item policies (see Item Policies).

PermissionDescription
Read Item PolicyAllows seeing item policies.
Add Item PolicyAllows adding item policies.
Edit Item PolicyAllows editing item policies.
Delete Item PolicyAllows deleting item policies.

Assignee Policies

Control who can manage automated item assignee assignment rules.

PermissionDescription
Read Assignee PolicyAllows seeing item assignee policies.
Add Assignee PolicyAllows adding item assignee policies.
Edit Assignee PolicyAllows editing item assignee policies.
Delete Assignee PolicyAllows deleting item assignee policies.

Reviewers

Control who can manage reviewer assignments on change requests.

PermissionDescription
Add ReviewerAllows adding reviewers to change requests.
Edit ReviewerAllows editing reviewers on change requests.
Remove ReviewerAllows removing reviewers from change requests.
Read ReviewersAllows seeing reviewers on change requests.

Assignees

Control who can manage assignee assignments on change requests.

PermissionDescription
Add AssigneeAllows adding assignees to change requests.
Edit AssigneeAllows editing assignees on change requests.
Remove AssigneeAllows removing assignees from change requests.
Read AssigneesAllows seeing assignees on change requests.

Threads

Control who can manage discussion threads on change requests.

PermissionDescription
Create ThreadAllows creating new discussion threads (comments, issues, or suggestions) on a change request.
Edit ThreadAllows editing existing thread messages.
Delete ThreadAllows deleting threads or messages.
Read ThreadsAllows reading threads on change requests.
Close ThreadAllows closing threads on change requests.
Resolve ThreadAllows resolving threads on change requests (required for merge when thread resolution is enforced).

CR Policies

Control who can manage automated change request policies.

PermissionDescription
Read CR PolicyAllows seeing change request policies.
Add CR PolicyAllows adding change request policies.
Edit CR PolicyAllows editing change request policies.
Delete CR PolicyAllows deleting change request policies.

Review Policies

Control who can manage auto-assignment reviewer rules.

PermissionDescription
Read Review PolicyAllows seeing change request reviewer policies.
Add Review PolicyAllows adding change request reviewer policies.
Edit Review PolicyAllows editing change request reviewer policies.
Delete Review PolicyAllows deleting change request reviewer policies.

Repository Audiences

Control who can manage audience permission settings.

PermissionDescription
Read Repository AudiencesSee repository audiences permissions.
Add Repository AudiencesAdd audiences to repository.
Edit Repository AudiencesEdit repository audiences permissions.
Remove Repository AudiencesRemove audiences from repository.

Repository Members

Control who can manage repository membership.

PermissionDescription
Read Repository MemberSee repository members.
Add Repository MemberAdd members to repository.
Edit Repository MemberEdit repository members.
Remove Repository MemberRemove members from repository.

Repository Roles

Control who can manage repository roles.

PermissionDescription
Read Repository RoleSee repository roles.
Add Repository RoleAdd repository roles.
Edit Repository RoleEdit repository roles.
Delete Repository RoleDelete repository roles.

Repository Groups

Control who can manage repository groups.

PermissionDescription
Read Repository GroupSee repository groups.
Add Repository GroupAdd groups to repository.
Edit Repository GroupEdit repository groups.
Remove Repository GroupRemove groups from repository.

Secrets

Control who can manage CI/CD secrets.

PermissionDescription
Read SecretsSee repository secrets.
Add SecretAdd repository secrets.
Delete SecretDelete repository secrets.

CI/CD

Control access to CI/CD pipelines and logs.

PermissionDescription
Run CICDRun CICD pipelines.
Read CICDRead CICD jobs.
Read CICD LogsRead CICD job logs.
Delete CICD JobDelete CICD jobs.
Delete CICD LogsDelete CICD job logs.

Billing

Control who pays for resource usage.

PermissionDescription
Bill Network Costs to Users (Public Read)If enabled, users who pull/clone pay network costs. If disabled, the repository owner pays.
Bill CICD Costs to Users (Public Read)If enabled, users will pay for CICD jobs they start. If disabled, the repository owner pays.

Repository Settings

Configurable values that control repository defaults. These appear in the repository settings edit form.

SettingTypeDefaultDescription
Default Branch NameTextmasterThe default branch name created when initializing a new repository.
CICD Config FilesText.project113/The file or directory the platform reads for CI/CD pipeline configuration.
CICD Data Retention DaysNumber60Number of days to retain CI/CD job metadata before automatic cleanup.
CICD Logs Retention DaysNumber30Number of days to retain CI/CD job logs before automatic cleanup.

Change Request Defaults

Configurable values that control change request behavior. These appear in the repository settings edit form and CR policy modals.

SettingTypeDefaultDescription
Merge StrategySelectmergeDefault merge strategy for new CRs. Options: merge, squash, rebase.
Sync StrategySelectmergeHow CRs stay up to date with the target branch. Options: manual, merge, rebase.
Auto Delete Source BranchCheckboxoffAutomatically delete the source branch after a CR is merged.
Auto RetargetCheckboxoffAutomatically retarget dependent CRs when the target branch of a CR changes.
Require CI PassCheckboxoffBlock merging until all CI pipelines succeed.
Minimum ApprovalsNumber0Minimum number of approving reviews required before merging.
All Threads ResolvedCheckboxoffBlock merging until all discussion threads are resolved.
Allow Force MergeCheckboxonAllow merging even when approval or CI requirements are not met.
Auto MergeCheckboxoffAutomatically merge the CR when all conditions are satisfied.
Use CR TitleCheckboxoffUse the change request title as the merge commit message.
Custom Commit MessageText(empty)Custom default commit message template for merges.
Use Random CR IDsCheckboxoffGenerate random change request identifiers instead of sequential numbers.