Delete Branch

Delete a branch from a node.

Safe by default: the branch must be merged into main (or have an open PR that was merged) before deletion is allowed. Pass force=true to delete an unmerged branch, which discards any commits unique to it.

The main branch cannot be deleted.

Requires editor or owner role on the organization — viewers cannot delete branches.

DELETE /orgs/{org_id}/nodes/{node_id}/branches/{branch_name}

Delete Branch

cURL

curl --request DELETE \
  --url https://api.yertle.com/orgs/{org_id}/nodes/{node_id}/branches/{branch_name}

200

{
  "message": "<string>"
}

Headers

authorization · string | null

Path Parameters

org_id · string · required

node_id · string · required

branch_name · string · required

Query Parameters

force · boolean · default: false

Response

200

application/json

Successful Response

Minimal response carrying a human-readable message.

message · string · required

Human-readable status message