> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doconda.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Editar

> Aplica cambios a tu Word, PowerPoint, Excel o PDF sin tocar nada más.

```json theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
{
  "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](/es/guides/create#niveles-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](/es/guides/review). 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

Si alguien cambia el archivo a mano (en el editor del panel, en el plugin de editor, o en Word o Excel), guárdalo encima
del mismo documento:

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
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](/es/guides/review).
* 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.