> ## 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={null}
{
  "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 hace el mismo agente que [crea](/guides/create#cómo-se-hace), con el mismo esfuerzo según el
  [nivel](/guides/create#niveles-de-calidad):
  * **Word**: abre el archivo, junta los trozos de texto que Word separa, cambia su XML con un programa y lo comprueba
    contra el original. Si pides control de cambios, cada cambio va marcado (insertado o borrado) a nombre de
    «Doconda»; también puede añadir comentarios o aceptar todos los cambios pendientes.
  * **PowerPoint**: mira las diapositivas, duplica, ordena o borra las que haga falta y cambia sus textos, manteniendo
    el diseño.
  * **Excel**: lo abre con openpyxl, cambia lo que pides con fórmulas de verdad y recalcula hasta que no queda ningún
    error.
  * **PDF**: lo cambia en el propio PDF.
* Lo nuevo copia el formato del documento: una cláusula añadida sigue la numeración y el aspecto de las que ya hay.
* `.doc`, `.ppt` y `.xls`, o si el agente no puede terminar (`agent.fallback`): se edita por el camino rápido, que
  convierte la petición en cambios concretos. Cada cambio llega como evento `edit.operation_applied` con el antes y el
  después, y queda en el informe (`edits`); si no sabe convertirla, el documento termina en `failed` con
  `edit_not_understood` y no se cobra. En un PDF, si pides más que cambiar texto, lo pasa a Word (`pdf.converted`).
* Después se revisa como en [Revisar](/guides/review).
* Máximo 50 páginas.

## Guardar una versión editada a mano

Si alguien cambia el archivo a mano (en el editor del panel, o en Word o Excel) y quieres guardarlo en Doconda, envíalo
como versión nueva del documento:

```bash theme={null}
curl https://api.eu.doconda.com/v1/documents/doc_01JAB3.../versions \
  -H "Authorization: Bearer $DOCONDA_KEY" \
  -F file=@informe-corregido.docx
```

* Crea un documento nuevo con `mode: "manual"` y `parent_id` apuntando al original. El original no cambia.
* Pasa por la misma revisión que el resto (PDF, vistas previas, informe), y el informe lista qué párrafos, celdas o
  textos se añadieron, cambiaron o quitaron (`changes`).
* Tiene que ser el mismo formato que el documento (Word, Excel o PowerPoint); 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.