Rename a branch

Renames a branch in a repository.

The permissions required to use this endpoint depends on whether you are renaming the default branch.

To rename a non-default branch:

• Users must have push access.
• Apps must have the contents:write repository permission.

To rename the default branch:

• Users must have admin or owner permissions.
• Apps must have the administration:write repository permission.