---
title: "Stop tracking a Factory Branch"
method: DELETE
path: "/factory/{uid}/branches/{branch_uid}"
tags: ["Factories"]
---

# Stop tracking a Factory Branch

`DELETE /factory/{uid}/branches/{branch_uid}`

## Request

- Base URL: `https://app.warp.dev/api/v1`
- URL: `https://app.warp.dev/api/v1/factory/{uid}/branches/{branch_uid}`
- Auth: HTTP bearer

Requires Factory view plus source.apply. Retirement blocks future
execution boundaries without deleting the Git head, cancelling
already-loaded work, or deleting production resources.
Repeated authorized deletion, including after purge, returns 204.
Requires factory_branches.

## Path parameters

- `uid` string, required
- `branch_uid` string, required

## Response `204`

Tracking retired or already absent

## Other responses

- `401`: Authentication required
- `403`: Factory access is not enabled for the authenticated principal
- `404`: Hidden Factory, unknown or cross-Factory tracking, or disabled Branch surface
- `409`: Classified conflict with reason branch_sync_pending, branch_head_moved, factory_source_changed, branch_deleted, or factory_scope_unavailable. Pending synchronization, moving heads, and source changes are retryable; deleted or unavailable identity is not.
- `500`: Retryable resource_unavailable for source, synchronization, or database failure

## Changes

- **2026-10-19** `2c45dcc0a13e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/warp/apis/oz-agent-api/changes/factory/:uid/branches/:branch_uid/delete.md)

---

[API](https://skmtc.dev/warp/apis/oz-agent-api.md) - [All operations](https://skmtc.dev/warp/apis/oz-agent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/warp/apis/oz-agent-api/revisions/4b5d145669be?raw)