Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/sheeplettuce/Monitor/llms.txt

Use this file to discover all available pages before exploring further.

Monitor API provides two evidence deletion endpoints: one to delete a single file record by ID, and one to remove the entire evidence folder for an expediente (typically used when rolling back a claim creation). Both endpoints require authentication; role requirements differ between them.

​
Delete a Single Evidence File

DELETE /api/expedientes/:no_siniestro/evidencias/:id
Authentication: Bearer token required. Only the Administrador role may call this endpoint. Deletes the evidence record from the database and removes the physical file from disk. If the stored ruta path exists on the filesystem, the file is deleted with fs.unlinkSync before the database record is removed.
Physical file deletion is a best-effort operation — if the file is already missing from disk, the deletion proceeds and the database record is still removed without error.

​
Path Parameters

​
no_siniestro
string
required
The siniestro number of the parent expediente (e.g. SIN-2024-001).
​
id
integer
required
Numeric ID of the evidencia record to delete. Returns 400 if the value cannot be parsed as an integer, and 404 if no record with that ID exists.

​
Example Request

curl -X DELETE http://localhost:3000/api/expedientes/SIN-2024-001/evidencias/42 \
  -H "Authorization: Bearer $ADMIN_TOKEN"

​
Response

​
200 — Success

Returns a confirmation object when the record has been deleted.
​
ok
boolean
Always true on successful deletion.
{ "ok": true }

​
Error Responses

StatusMeaning
400id is missing or cannot be coerced to an integer, or no_siniestro is not a valid string.
401Missing or invalid Bearer token.
403Authenticated user does not have the Administrador role.
404No evidencia record with the given id was found.
500Internal server error — check server logs.
// 400 — bad ID
{ "error": "ID inválido" }

// 400 — bad siniestro
{ "error": "Número de siniestro inválido" }

// 404
{ "error": "Evidencia no encontrada" }

// 500
{ "error": "Error interno al eliminar evidencia" }

​
Delete the Entire Evidence Folder

DELETE /api/expedientes/:no_siniestro/evidencias
Authentication: Bearer token required. Administrador and Operador roles may call this endpoint. Recursively removes the evidencias/<no_siniestro>/ directory and all of its contents from disk using fsp.rm(carpeta, { recursive: true, force: true }). This permanently wipes both the evidencias/ (photos) and DOCUMENTOS REPARACION/ subfolders in a single operation. Database records are not removed by this endpoint — use Delete a Single Evidence File to clean up individual DB rows if needed.
This operation is irreversible. All files uploaded for the expediente — photos and documents alike — are permanently deleted from disk. There is no undo. Use this endpoint only when intentionally rolling back a claim, such as during a failed expediente creation workflow.

​
Path Parameters

​
no_siniestro
string
required
The siniestro number of the expediente whose evidence folder should be removed (e.g. SIN-2024-001). The server validates that the resolved path stays within EVIDENCIAS_BASE (the hardcoded base directory derived from __dirname in evidencias.routes.ts) to prevent path traversal attacks.

​
Example Request

curl -X DELETE http://localhost:3000/api/expedientes/SIN-2024-001/evidencias \
  -H "Authorization: Bearer $TOKEN"

​
Response

​
200 — Success

​
ok
boolean
Always true when the folder has been removed (or did not exist — force: true suppresses “not found” errors).
{ "ok": true }

​
Error Responses

StatusMeaning
400no_siniestro is not a valid string, or the resolved path falls outside EVIDENCIAS_BASE (path traversal guard).
401Missing or invalid Bearer token.
403Authenticated user does not have the Administrador or Operador role.
500Filesystem error while removing the directory — check server logs.
// 400 — bad siniestro
{ "error": "Número de siniestro inválido" }

// 400 — path traversal blocked
{ "error": "Ruta inválida" }

// 500
{ "error": "No se pudo eliminar la carpeta" }

Build docs developers (and LLMs) love

Get started for freeTalk to us