code-security

Set a code security configuration as a default for an organization

Changed on

Sets a code security configuration as a default to be applied to new repositories in your organization.

This configuration will be applied to the matching repository type (all, none, public, private and internal) by default when they are created.

The authenticated user must be an administrator or security manager for the organization to use this endpoint. Setting an enterprise-enforced configuration as the default also requires permission to manage the enterprise's code security settings.

A default set with this endpoint is an organization default, even if the configuration is owned or enforced by the enterprise. An enterprise-enforced configuration set as an enterprise-level default for the same repository visibility takes precedence.

OAuth app tokens and classic PATs require the write:org scope; setting an enterprise-enforced configuration as the default also requires admin:enterprise. Fine-grained PATs and GitHub App access tokens cannot perform that action.

put/orgs/{org}/code-security/configurations/{configuration_id}/defaults

Request

  • Base URL: https://api.github.com
  • URL: https://api.github.com/orgs/{org}/code-security/configurations/{configuration_id}/defaults
  • Auth: none declared

Path parameters

orgstring required

The organization name. The name is not case sensitive.

configuration_idinteger required

The unique identifier of the code security configuration.

Request body

default_for_new_repos'all' | 'none' | 'private_and_internal' | 'public'

Specify which types of repository this security configuration should be applied to by default.

Response

Default successfully changed.

default_for_new_repos'all' | 'none' | 'private_and_internal' | 'public'

Specifies which types of repository this security configuration is applied to by default.

Changes

  • 2026-03-10fdfb492d0f0cRevision changes
    • info

      added the non-success response with the status

  • 2026-03-106ea91bcbb8e2Revision changes
    • warning

      added the new enterprise_enforced enum value to the / response property for the response status