Project

Create a branch

Create a new branch, or rename and confirm the default branch.

post/v2/project/branches/create

Headers

gt-api-version'2025-01-01.v0' | '2025-11-03.v1' | '2026-02-18.v1' | '2026-03-06.v1'

API contract version. Defaults to the oldest supported version.

API contract version. Defaults to the oldest supported version.

gt-project-idstring

Target project ID when no project ID is present in the path. Project API keys default to their bound project. If supplied, the header must match both the path target and the key’s bound project.

Target project ID when no project ID is present in the path. Project API keys default to their bound project. If supplied, the header must match both the path target and the key’s bound project.

Request body

branchNamestring required
defaultBranchboolean

Response

Created or existing branch

Changes

Changed in 3 of the 15 revisions of this API.118

    • ○

      the endpoint scheme security UserBearerAuth was removed from the API

      api-security-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ○

      the endpoint scheme security UserBearerAuth was added to the API

      api-security-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 367cd605d090116See the full diff
    • ▲

      removed the media type text/plain for the response with the status

      response-media-type-removed

    • ○

      the endpoint scheme security BearerAuth was added to the API

      api-security-added

    • ○

      api tag Project added

      api-tag-added

    • ○

      api tag Branches removed

      api-tag-removed

    • ○

      added the media type application/json for the response with the status

      response-media-type-added

    • ○

      added the media type text/html for the response with the status

      response-media-type-added

    • ○

      added the media type text/html for the response with the status

      response-media-type-added

    • ○

      added the media type text/html for the response with the status

      response-media-type-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      the response property became required for the status

      response-property-became-required

    • ○

      the response property / became required for the status

      response-property-became-required

    • ○

      the response property / became required for the status

      response-property-became-required

    • ○

      the response property became required for the status

      response-property-became-required

    • ○

      the response property became required for the status

      response-property-became-required

    This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog