---
title: "DELETE /docs-projects/{uid}/branches"
method: DELETE
path: "/docs-projects/{uid}/branches"
---

# DELETE /docs-projects/{uid}/branches

`DELETE /docs-projects/{uid}/branches`

## Request

- Base URL: `https://api.scalar.com/core`
- URL: `https://api.scalar.com/core/docs-projects/{uid}/branches`
- Auth: HTTP bearer

Delete a branch from the connected Docs repository

## Path parameters

- `uid` string, required

## Request body

- object
  - `branch` string, required
  - `repositoryKey` string, required

## Response `200`

Default Response

- unknown

## Other responses

- `400`: Bad request
- `401`: No auth
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid payload
- `500`: Uncaught error

## Changes

- **2026-09-30** `05e000a4b9ec`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scalar/apis/core/changes/docs-projects/:uid/branches/delete.md)

---

[API](https://skmtc.dev/scalar/apis/core.md) - [All operations](https://skmtc.dev/scalar/apis/core/llms.txt) - [OpenAPI document](https://skmtc.dev/scalar/apis/core/revisions/b3aa8493faa8?raw)