| Modo | Cómo | Respuesta |
|---|---|---|
| Directo | (por defecto) | 200 con el documento terminado y sus outputs. Si pasa de 120 s (lo normal en standard y best), 202 con el documento aún en marcha y sigues con GET; el create() de los SDK sigue esperando por ti. |
| Stream | "stream": true | text/event-stream con los eventos hasta el final. |
| Background | "background": true | 202 inmediato. Sigue con GET /documents/{id}, /events o webhooks. |
Stream
curl -N https://api.eu.doconda.com/v1/documents \
-H "Authorization: Bearer $DOCONDA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "format": "docx", "content": { "markdown": "# Nota interna\n\n..." }, "stream": true }'
id: 3
event: content.block_started
data: {"id":"evt_…","type":"content.block_started","sequence":3,…}
Si se corta la conexión, el documento se sigue haciendo. Reengánchate con
GET /documents/{id}/events y la cabecera Last-Event-ID.