Create branch

POST /api/v1/repos/branches/create

Create a new branch from an existing branch, optionally across the ephemeral namespace.

POST /api/v1/repos/branches/create
Authorization: Bearer YOUR_JWT_TOKEN
Content-Type: application/json

{
  "base_branch": "main",
  "target_branch": "feature/new-onboarding",
  "base_is_ephemeral": false,
  "target_is_ephemeral": false
}

Request Body

Parameter	Type	Description
base_branch	Required	Source branch name.
target_branch	Required	Destination branch name.
base_is_ephemeral	Optional	When true, treat base_branch as ephemeral.
target_is_ephemeral	Optional	When true, create the target in the ephemeral namespace.
force	Optional	When true, allow non-fast-forward updates.
preferred_base	Optional	Optional fallback base branch name used by the backend.

JWT Requirements

• The JWT must include the repository in the repo claim
• Requires git:write scope

Response

{
  "message": "branch created",
  "target_branch": "feature/new-onboarding",
  "target_is_ephemeral": false,
  "commit_sha": "abc123..."
}

Error Responses

Status	Description
400 Bad Request	Invalid branch name or request body
401 Unauthorized	Invalid JWT or missing authorization header
403 Forbidden	Missing git:write scope
404 Not Found	Repository not found