Repositories

Change the default branch

Starts an idempotent default-branch change guarded by expectedVersion. Returns 200 when complete or 202 while native work remains pending. Requires authenticated authority and enforces current resource policy.

put/api/repos/{owner}/{repo}/settings/default-branch/

Request

  • Base URL
    https://git.cafe
  • Auth
    • API key in cookie gc-session
    • or HTTP bearer
    • or HTTP basic
    • or HTTP token
    • or OAuth 2
      Authorization code: /api/oauth/authorize
      Token URL: /api/oauth/token scopes: repo:administration:admin

Path parameters

ownerstring required
repostring required

Request body

requestIdstring uuid required
expectedVersioninteger required
defaultBranchstring required

Response

Response for status 200

idstring required
state'pending' | 'completed' | 'failed' | 'conflict' required
defaultBranchstring required
versioninteger required

Changes

No recorded changes to this operation across all 1 revision of this API.