# Eliminar (/docs/developers/api-reference/departments/delete)

## Descripcion general [#descripcion-general]

Este endpoint realiza el **borrado** del departamento: a partir de ese momento deja de aparecer en `GET /api/v1/departments` y se trata como no encontrada en `PATCH`/`DELETE` (`404`). El borrado **no es recursivo**: si el departamento tiene hijos vivos, la solicitud falla — primero debes eliminarlos o re-asignarlos a otro padre. Si el departamento está **vinculado a un centro de costos**, el CC controla su ciclo de vida y el borrado directo se rechaza con `409` — elimina o desvincula el CC. Al eliminar el departamento, se **desvincula de cada empleo** que lo referenciaba (su `department_code` queda en `null`).

## Endpoint [#endpoint]

`DELETE https://app.integranom.com/api/v1/departments/{department_number}`

**Path param:** `department_number` — entero positivo, el número de departamento dentro de la organización.

## Solicitud [#solicitud]

***

Sin cuerpo. La API responde `204 No Content` si el borrado tuvo éxito.

**cURL**

```bash
curl -X DELETE "https://app.integranom.com/api/v1/departments/5" \
-H "Authorization: Bearer TU_API_KEY"
```

**Respuesta**

```text
204 No Content
```

## Comportamiento [#comportamiento]

* La fila deja de devolverse por `GET /api/v1/departments`.
* **Rechaza** la solicitud (`409`) si el departamento está **vinculado a un centro de costos** — el CC controla su ciclo de vida; elimínalo o desvincúlalo primero.
* **Rechaza** la solicitud (`400`) si el departamento tiene **hijos vivos** — primero elimínalos o reasígnalos a otro padre con [PATCH](/docs/developers/api-reference/departments/edit).
* **Desvincula** el departamento de cada empleo que lo referenciaba: el `department_code` de esos empleos queda en `null` (dentro de la misma transacción).

## Errores [#errores]

| Status | Causa                                                                                                                                                                    |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `400`  | `department_number` inválido en la URL, o el departamento tiene hijos vivos.                                                                                             |
| `409`  | El departamento está vinculado a un centro de costos. Cuerpo: `{ "message": "This department is managed by a cost center. Unlink or delete the cost center instead." }`. |
| `404`  | El departamento no existe o ya fue eliminado en esta organización.                                                                                                       |