Update a project's settings and configuration.

Update a project's settings and configuration. This endpoint allows updating a wide variety of project properties including metadata, policy assignments, scanning settings, integration configurations, and more.

Permission Requirements

Most fields require Edit permission on the project. The following fields require special permissions:

• public: Requires MakePublic permission
• policyId, securityPolicyId, qualityPolicyId, sbomPolicyId, sbomAnalysisEnabled: Require SetPolicy permission for the respective policy type

Special Behaviors

Branch Management

• tracking_branches and hidden_branches are mutually exclusive. Adding a branch to one will automatically remove it from the other.
• Only branches can be added to these arrays; tags are filtered out automatically.

Policy Changes

• When policies or scanning settings change, the project will be automatically rescanned if the last analyzed revision is in a steady state.

Feature Flags

• securityIssueScanningEnabled and qualityIssueScanningEnabled can only be modified if the organization has the respective features enabled.

Issue Tracker Fields

• When updating issueTrackerCustomFields, boolean values in the isRequired field may be stringified and will be automatically converted.
• Custom field configurations are validated against Jira field requirements.

Notifications

• Empty notification objects are automatically filtered out.
• Notification changes are processed asynchronously.