--- title: "Changes to Rename a branch" method: POST path: "/repos/{owner}/{repo}/branches/{branch}/rename" --- # Changes to Rename a branch `POST /repos/{owner}/{repo}/branches/{branch}/rename` > Every recorded change to this operation, newest first. > 240 revisions in range; 1 not diffed. ## Timeline Changed in 9 of 240 revisions. - **2026-06-23** (2022-11-28) `fd784b1d2c89`: 3 info - **2026-03-04** (2022-11-28) `7319ddbf8c57`: 2 breaking, 43 info - **2025-08-01** (2022-11-28) `5cd155b9d2ed`: 6 warning - **2025-02-07** (2022-11-28) `39fc11b4e941`: 40 breaking, 8 warning, 1 info - **2024-12-12** (2022-11-28) `d96919b458fd`: 1 info - **2024-10-25** (2022-11-28) `03a5cc0c9fb4`: 8 info - **2024-08-19** (2022-11-28) `54ede6dc47d6`: 1 info - **2024-07-09** (2022-11-28) `e2d80da3f4a7`: 40 breaking, 6 warning - **2024-04-28** (2022-11-28) `0c85e5aa5482`: 2 breaking ## Changes - **2026-06-23** (2022-11-28) `fd784b1d2c89`: 3 info - added the optional property `protection/required_pull_request_reviews/bypass_pull_request_allowances/teams/items/access_source` to the response with the `201` status - added the optional property `protection/required_pull_request_reviews/dismissal_restrictions/teams/items/access_source` to the response with the `201` status - added the optional property `protection/restrictions/teams/items/access_source` to the response with the `201` status - **2026-03-04** (2022-11-28) `7319ddbf8c57`: 2 breaking, 43 info - the response property `commit/files/items/sha` became nullable for the status `201` - the `protection/restrictions/teams/items/parent` response's property type changed from `string` to `object` for status `201` - added the optional property `protection/required_pull_request_reviews/bypass_pull_request_allowances/teams/items/enterprise_id` to the response with the `201` status - added the optional property `protection/required_pull_request_reviews/bypass_pull_request_allowances/teams/items/organization_id` to the response with the `201` status - added the optional property `protection/required_pull_request_reviews/bypass_pull_request_allowances/teams/items/parent/enterprise_id` to the response with the `201` status - added the optional property `protection/required_pull_request_reviews/bypass_pull_request_allowances/teams/items/parent/organization_id` to the response with the `201` status - added the optional property `protection/required_pull_request_reviews/dismissal_restrictions/teams/items/enterprise_id` to the response with the `201` status - added the optional property `protection/required_pull_request_reviews/dismissal_restrictions/teams/items/organization_id` to the response with the `201` status - added the optional property `protection/required_pull_request_reviews/dismissal_restrictions/teams/items/parent/enterprise_id` to the response with the `201` status - added the optional property `protection/required_pull_request_reviews/dismissal_restrictions/teams/items/parent/organization_id` to the response with the `201` status - added the optional property `protection/restrictions/teams/items/enterprise_id` to the response with the `201` status - added the optional property `protection/restrictions/teams/items/organization_id` to the response with the `201` status - added the optional property `protection/restrictions/teams/items/parent/enterprise_id` to the response with the `201` status - added the optional property `protection/restrictions/teams/items/parent/ldap_dn` to the response with the `201` status - added the optional property `protection/restrictions/teams/items/parent/notification_setting` to the response with the `201` status - added the optional property `protection/restrictions/teams/items/parent/organization_id` to the response with the `201` status - added the optional property `protection/restrictions/teams/items/parent/privacy` to the response with the `201` status - added the optional property `protection/restrictions/teams/items/permissions` to the response with the `201` status - the response property `protection/restrictions/teams/items/description` became required for the status `201` - the response property `protection/restrictions/teams/items/html_url` became required for the status `201` - the response property `protection/restrictions/teams/items/id` became required for the status `201` - the response property `protection/restrictions/teams/items/members_url` became required for the status `201` - the response property `protection/restrictions/teams/items/name` became required for the status `201` - the response property `protection/restrictions/teams/items/node_id` became required for the status `201` - the response property `protection/restrictions/teams/items/parent` became required for the status `201` - the response property `protection/restrictions/teams/items/permission` became required for the status `201` - the response property `protection/restrictions/teams/items/repositories_url` became required for the status `201` - the response property `protection/restrictions/teams/items/slug` became required for the status `201` - the response property `protection/restrictions/teams/items/url` became required for the status `201` - added the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/teams/items/parent/type` to the response with the `201` status - added the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/teams/items/type` to the response with the `201` status - added the required property `protection/required_pull_request_reviews/dismissal_restrictions/teams/items/parent/type` to the response with the `201` status - added the required property `protection/required_pull_request_reviews/dismissal_restrictions/teams/items/type` to the response with the `201` status - added the required property `protection/restrictions/teams/items/parent/description` to the response with the `201` status - added the required property `protection/restrictions/teams/items/parent/html_url` to the response with the `201` status - added the required property `protection/restrictions/teams/items/parent/id` to the response with the `201` status - added the required property `protection/restrictions/teams/items/parent/members_url` to the response with the `201` status - added the required property `protection/restrictions/teams/items/parent/name` to the response with the `201` status - added the required property `protection/restrictions/teams/items/parent/node_id` to the response with the `201` status - added the required property `protection/restrictions/teams/items/parent/permission` to the response with the `201` status - …5 more - **2025-08-01** (2022-11-28) `5cd155b9d2ed`: 6 warning - removed the optional property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/client_secret` from the response with the `201` status - removed the optional property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/pem` from the response with the `201` status - removed the optional property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/webhook_secret` from the response with the `201` status - removed the optional property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/client_secret` from the response with the `201` status - removed the optional property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/pem` from the response with the `201` status - removed the optional property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/webhook_secret` from the response with the `201` status - **2025-02-07** (2022-11-28) `39fc11b4e941`: 40 breaking, 8 warning, 1 info - added `#/components/schemas/simple-user, #/components/schemas/enterprise` to the `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner` response property `oneOf` list for the response status `201` - added `#/components/schemas/simple-user, #/components/schemas/enterprise` to the `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner` response property `oneOf` list for the response status `201` - the `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner` response's property type changed from `object` to no type for status `201` - the `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner` response's property type changed from `object` to no type for status `201` - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/avatar_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/events_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/followers_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/following_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/gists_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/gravatar_id` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/html_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/id` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/login` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/node_id` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/organizations_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/received_events_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/repos_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/site_admin` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/starred_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/subscriptions_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/type` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/avatar_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/events_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/followers_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/following_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/gists_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/gravatar_id` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/html_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/id` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/login` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/node_id` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/organizations_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/received_events_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/repos_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/site_admin` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/starred_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/subscriptions_url` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/type` from the response with the `201` status - removed the required property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/url` from the response with the `201` status - …9 more - **2024-12-12** (2022-11-28) `d96919b458fd`: 1 info - added the optional property `commit/commit/verification/verified_at` to the response with the `201` status - **2024-10-25** (2022-11-28) `03a5cc0c9fb4`: 8 info - added the optional property `commit/author/oneOf[subschema #1: Simple User]/user_view_type` to the response with the `201` status - added the optional property `commit/committer/oneOf[subschema #1: Simple User]/user_view_type` to the response with the `201` status - added the optional property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/owner/user_view_type` to the response with the `201` status - added the optional property `protection/required_pull_request_reviews/bypass_pull_request_allowances/users/items/user_view_type` to the response with the `201` status - added the optional property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/owner/user_view_type` to the response with the `201` status - added the optional property `protection/required_pull_request_reviews/dismissal_restrictions/users/items/user_view_type` to the response with the `201` status - added the optional property `protection/restrictions/apps/items/owner/user_view_type` to the response with the `201` status - added the optional property `protection/restrictions/users/items/user_view_type` to the response with the `201` status - **2024-08-19** (2022-11-28) `54ede6dc47d6`: 1 info - added the optional property `protection/restrictions/apps/items/client_id` to the response with the `201` status - **2024-07-09** (2022-11-28) `e2d80da3f4a7`: 40 breaking, 6 warning - added `#/components/schemas/simple-user, #/components/schemas/empty-object` to the `commit/author` response property `oneOf` list for the response status `201` - added `#/components/schemas/simple-user, #/components/schemas/empty-object` to the `commit/committer` response property `oneOf` list for the response status `201` - the `commit/author` response's property type changed from `object` to no type for status `201` - the `commit/committer` response's property type changed from `object` to no type for status `201` - removed the required property `commit/author/avatar_url` from the response with the `201` status - removed the required property `commit/author/events_url` from the response with the `201` status - removed the required property `commit/author/followers_url` from the response with the `201` status - removed the required property `commit/author/following_url` from the response with the `201` status - removed the required property `commit/author/gists_url` from the response with the `201` status - removed the required property `commit/author/gravatar_id` from the response with the `201` status - removed the required property `commit/author/html_url` from the response with the `201` status - removed the required property `commit/author/id` from the response with the `201` status - removed the required property `commit/author/login` from the response with the `201` status - removed the required property `commit/author/node_id` from the response with the `201` status - removed the required property `commit/author/organizations_url` from the response with the `201` status - removed the required property `commit/author/received_events_url` from the response with the `201` status - removed the required property `commit/author/repos_url` from the response with the `201` status - removed the required property `commit/author/site_admin` from the response with the `201` status - removed the required property `commit/author/starred_url` from the response with the `201` status - removed the required property `commit/author/subscriptions_url` from the response with the `201` status - removed the required property `commit/author/type` from the response with the `201` status - removed the required property `commit/author/url` from the response with the `201` status - removed the required property `commit/committer/avatar_url` from the response with the `201` status - removed the required property `commit/committer/events_url` from the response with the `201` status - removed the required property `commit/committer/followers_url` from the response with the `201` status - removed the required property `commit/committer/following_url` from the response with the `201` status - removed the required property `commit/committer/gists_url` from the response with the `201` status - removed the required property `commit/committer/gravatar_id` from the response with the `201` status - removed the required property `commit/committer/html_url` from the response with the `201` status - removed the required property `commit/committer/id` from the response with the `201` status - removed the required property `commit/committer/login` from the response with the `201` status - removed the required property `commit/committer/node_id` from the response with the `201` status - removed the required property `commit/committer/organizations_url` from the response with the `201` status - removed the required property `commit/committer/received_events_url` from the response with the `201` status - removed the required property `commit/committer/repos_url` from the response with the `201` status - removed the required property `commit/committer/site_admin` from the response with the `201` status - removed the required property `commit/committer/starred_url` from the response with the `201` status - removed the required property `commit/committer/subscriptions_url` from the response with the `201` status - removed the required property `commit/committer/type` from the response with the `201` status - removed the required property `commit/committer/url` from the response with the `201` status - …6 more - **2024-04-28** (2022-11-28) `0c85e5aa5482`: 2 breaking - the response property `protection/required_pull_request_reviews/bypass_pull_request_allowances/apps/items/` became nullable for the status `201` - the response property `protection/required_pull_request_reviews/dismissal_restrictions/apps/items/` became nullable for the status `201` --- [Operation](https://skmtc.dev/github/apis/rest/docs/repos/:owner/:repo/branches/:branch/rename/post.md) - [API](https://skmtc.dev/github/apis/rest.md) - [Page](https://skmtc.dev/github/apis/rest/changes/repos/:owner/:repo/branches/:branch/rename/post)