# Eliminar un documento

Fuente: /document-management/delete-document/

Eliminar un documento lo quita de tu cuenta: deja de aparecer en tus listados y ya no se puede consultar ni descargar por API. Úsalo para limpiar documentos creados por error o procesos que ya no vas a continuar.

**Método:**  DELETE `https://api.digitafirma.com/v1/documents/{uuid}`

### Path Parameters

| Campo | Tipo | Descripción |
| :- | :- | :- |
| `uuid` | `string` | ID del documento que quieres eliminar. |

Este endpoint no recibe cuerpo (*body*).

> **No se puede deshacer por API**
>
> No existe un endpoint para recuperar un documento eliminado, y la eliminación procede **en cualquier estado**, aunque el documento ya esté firmado. Si necesitas conservar la evidencia, descarga antes el [expediente en ZIP](/document-management/download-file).
>
> Si solo quieres sacarlo de tus listados sin perderlo, [archívalo](/document-management/archive-document) en lugar de eliminarlo.

***

### Qué pasa al eliminar

**Desaparece de tu cuenta**

El documento deja de aparecer en todos los listados (`GET /v1/documents`, `GET /v1/documents/archived` y `GET /v1/documents/invited`). Si lo [consultas](/document-management/show-document) o intentas descargar sus archivos con su `uuid`, la API responde `El documento no fue encontrado`.

**Avisa a los firmantes**

Cada firmante del documento, incluidos los que ya firmaron, recibe un correo con el asunto **"Han eliminado un documento"**, con el nombre del archivo y de quien lo envió.

**No envía webhook**

La eliminación **no dispara** un [webhook de documento](/webhooks/document-webhooks). Si tu sistema necesita registrar la baja, hazlo cuando recibas la respuesta `204`.

**Quién puede eliminarlo**

Cualquier usuario que pertenezca a la carpeta de trabajo del documento, no solo quien lo creó. Los documentos que viven dentro de un contenedor no se eliminan con este endpoint: para eso está [Eliminar un contenedor](/containers/delete-container).

***

### Ejemplo de integración

**curl**

```bash
curl --location --request DELETE 'https://api.digitafirma.com/v1/documents/{uuid}' \
--header 'X-Api-Key: {X-API-KEY}'
```

**Respuesta Exitosa (204 No Content)**

La respuesta no trae cuerpo. El código `204` confirma que el documento se eliminó.

**Error (400)**

```json
{
  "errors": [
    {
      "status": 400,
      "title": "Domain Error",
      "detail": "El documento no fue encontrado"
    }
  ]
}
```

***

### Errores comunes

| Código | Mensaje | Causa |
| :- | :- | :- |
| 400 | `El documento no fue encontrado` | El `uuid` no existe, el documento ya había sido eliminado, tu usuario no pertenece a la carpeta de trabajo del documento, o el documento está dentro de un contenedor. |
| 401 | — | Falta la `X-Api-Key` o no es válida. |

> **¿Solo quieres ordenar tus listados?**
>
> [Archivar un documento](/document-management/archive-document) lo saca de tus listados sin borrarlo, y puedes desarchivarlo cuando quieras.