Editar

{
  "operation": "edit",
  "file": "file_01JAB3...",
  "prompt": "Títulos en azul y añade una cláusula de confidencialidad"
}

• Sirve para Word, PowerPoint, Excel y PDF. El resultado sale en el mismo formato, con su PDF. También acepta .doc, .ppt y .xls; el resultado sale en .docx, .pptx o .xlsx.
• file puede ser un fichero subido o un documento que ya hizo Doconda, por su id ("doc_01JAB3…").
• Solo cambia lo que pides; el resto queda idéntico. Lo nuevo copia el formato del documento: una cláusula añadida sigue la numeración y el aspecto de las que ya hay.
• En standard y best: en Word puedes pedir control de cambios (cada cambio marcado a nombre de «Doconda»), añadir comentarios o aceptar los cambios pendientes; en PowerPoint, añadir, ordenar o quitar diapositivas manteniendo el diseño; en Excel, los cambios van con fórmulas reales.
• En fast, y siempre con .doc, .ppt y .xls (sea cual sea el nivel), se cambian textos y el estilo básico: sin control de cambios, comentarios ni diapositivas nuevas o reordenadas.
• El nivel de calidad funciona igual que al crear; con auto, pedir comentarios o control de cambios elige best. Un .doc, .ppt o .xls se edita, y se cobra, siempre en fast (quality.level: "fast").
• En fast y con .doc, .ppt y .xls, cada cambio llega como evento edit.operation_applied con el antes y el después, y queda en el informe (edits). En fast, en un PDF, si pides más que cambiar texto, sale como Word (pdf.converted).
• Si la petición no se puede convertir en cambios, el documento termina en failed con edit_not_understood y no se cobra.
• Si el resultado es un Word (.docx), se revisa como en Revisar. Un PowerPoint, un Excel o un PDF llevan su PDF y sus vistas, pero no esa revisión.
• Límites: un PDF, hasta 50 páginas (si no, file_rejected). En fast y con .doc, .ppt y .xls, hasta 3.000 párrafos, celdas o líneas (si no, document_too_long).

​

Guardar un archivo editado a mano

curl -X PUT https://api.eu.doconda.com/v1/documents/doc_01JAB3.../file \
  -H "Authorization: Bearer $DOCONDA_KEY" \
  -F revision=1 \
  -F file=@informe-corregido.docx

• Es el mismo documento: mismo id y mismos enlaces en tu app. revision sube en 1 con cada guardado.
• Se rehacen el PDF, las vistas previas y el informe, que lista qué párrafos, celdas o textos se añadieron, cambiaron o quitaron (changes). Si es un Word, además se revisa como en Revisar.
• Envía la revision que abriste (antes del archivo, si usas multipart). Si alguien guardó entretanto, falla con 409 revision_conflict en vez de pisar sus cambios: vuelve a abrirlo y repite los tuyos.
• La retención vuelve a contar desde este guardado (expires_at), salvo con retention: "none", que se borra igual a los 15 minutos de terminar.
• Si el archivo no se puede procesar, el documento se queda como estaba y la respuesta es el error. Con webhooks recibes document.updated o document.update_failed.
• Tiene que ser el mismo formato que el documento (Word, Excel, PowerPoint o PDF); si no, file_format_mismatch.
• No usa IA y no se cobra.