# Eliminar (/docs/developers/api-reference/job-positions/delete)

## Descripcion general [#descripcion-general]

Este endpoint realiza el **borrado** del puesto: a partir de ese momento deja de aparecer en `GET /api/v1/job-positions` y se trata como no encontrada en `PATCH`/`DELETE` (`404`).

La respuesta exitosa es `204 No Content` con cuerpo vacío.

A diferencia de departamentos y sucursales, los puestos **no forman un árbol**, así que no se verifica que tengan hijos vivos. Al eliminar el puesto, se **desvincula de cada empleo** que lo referenciaba: su `job_position_code` queda en `null` (misma transacción), de modo que ningún empleo queda apuntando a un puesto eliminado.

## Endpoint [#endpoint]

`DELETE https://app.integranom.com/api/v1/job-positions/{job_position_number}`

**Path param:** `job_position_number` — entero positivo, el número de puesto 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/job-positions/5" \
-H "Authorization: Bearer TU_API_KEY"
```

**Respuesta**

```text
204 No Content
```

## Comportamiento [#comportamiento]

* Marca el puesto como eliminado.
* La fila deja de devolverse por `GET /api/v1/job-positions`.
* Sin verificación de hijos (los puestos no forman árbol). Sí se **desvincula** el puesto de cada empleo que lo referenciaba: su `job_position_code` queda en `null`.

## Errores [#errores]

| Status | Causa                                                                |
| ------ | -------------------------------------------------------------------- |
| `400`  | `job_position_number` inválido en la URL.                            |
| `404`  | El puesto no existe o ya fue eliminado en esta organización.         |
| `409`  | El puesto tiene plazas sin cancelar. Cancélalas antes de eliminarlo. |