Eliminar un avalúo

Eliminar un avalúo borra definitivamente el avalúo y todo lo que depende de él: versiones del documento, evaluaciones, hallazgos, justificaciones, certificados y el historial de procesamiento. No se puede deshacer.

Requisitos:

Scope avaluos:delete.
La llave debe ser la misma que creó el avalúo. Ninguna otra llave puede borrarlo.

1 · Vista previa

GET/v1/avaluos/{folio}/previewavaluos:delete

Previsualiza la eliminación (dry-run)

Cuenta lo que se borraría, sin borrar nada:

curl "$API_URL/v1/avaluos/AVL-2026-000123/preview" -H "x-api-key: $API_KEY"

200 OK

{
  "folio": "AVL-2026-000123",
  "avaluo_id": "5b2f7c1e-3a4d-4f6b-9e21-8c7d6a5b4f3e",
  "estado": "requires_correction",
  "total": 22,
  "filas": {
    "documents": 1,
    "evaluations": 1,
    "evaluation_stages": 5,
    "evaluation_errors": 3,
    "justificaciones_avaluo": 1,
    "certificates": 0,
    "processing_jobs": 5,
    "processing_events": 5,
    "evaluacion_antecedentes": 0,
    "document_images": 0,
    "appraisals": 1
  }
}

2 · Eliminar

DELETE/v1/avaluos/{folio}avaluos:delete

Elimina el avalúo y todo lo relacionado

curl -X DELETE "$API_URL/v1/avaluos/AVL-2026-000123" -H "x-api-key: $API_KEY"

Responde 200 con el mismo conteo y "eliminado": true. Después, el folio queda libre y GET /v1/avaluos/{folio} responde 404.

Errores

HTTP	`message`	Causa
`403`	`Faltan scopes: avaluos:delete`	La llave no tiene el scope.
`403`	`Solo la API Key que creó el avalúo puede eliminarlo.`	La llave no es la que creó el avalúo.
`404`	`Avalúo '…' no encontrado`	El folio no existe.

Eliminar un avalúo

1 · Vista previa

2 · Eliminar

Errores

On this page