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}
| Campo | Tipo | Descripción |
|---|---|---|
uuid | string | ID del documento que quieres eliminar. |
Este endpoint no recibe cuerpo (body).
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 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. 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.
curl --location --request DELETE 'https://api.digitafirma.com/v1/documents/{uuid}' \--header 'X-Api-Key: {X-API-KEY}'La respuesta no trae cuerpo. El código 204 confirma que el documento se eliminó.
{ "errors": [ { "status": 400, "title": "Domain Error", "detail": "El documento no fue encontrado" } ]}| 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. |