Delete Branch
Enqueue an async task to delete a branch.
Returns **202 Accepted** with a task envelope — not 204. Poll `GET /sites/{site_id}/branches/tasks/{task_id}` until the task finishes.
<Warning title="Enterprise Only">This endpoint requires an Enterprise workspace with the page branching entitlement.</Warning>
Required scope | `branches:delete`
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
site_id
Unique identifier for a Site
branch_id
Unique identifier for a Branch
Response
Branch deletion task accepted
taskId
status
Task state at enqueue time (typically queued).
nextActions
Errors
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error