Saltar al contenido principal
POST
Crear o editar un documento (modo directo o background)

Autorizaciones

Authorization
string
header
requerido

Authorization: Bearer ak_eu_…, con una key del panel (API keys).

Encabezados

Idempotency-Key
string

Muy recomendable (los SDK siempre envían una). La misma key con el mismo cuerpo, en menos de 24 h y en el mismo proyecto, devuelve el mismo documento; con otro cuerpo, 422 idempotency_key_reused.

Parámetros de consulta

dry_run
boolean

Valida los campos, la operación y los archivos sin crear nada. No comprueba el estilo ni el saldo.

Cuerpo

application/json
operation
enum<string>
predeterminado:create
Opciones disponibles:
create,
edit
name
string

Un nombre para encontrarlo después («Contrato piso Malasaña»). También es el nombre de los archivos descargados.

Required string length: 1 - 200
format
enum<string>

El archivo que quieres. docx → Word (y también su PDF), pdf → solo el PDF, pptx → PowerPoint (con su PDF), xlsx → Excel (con su PDF). artifact → una página web que guarda datos (en el navegador de cada visitante, o compartidos por todos), en un enlace firmado; con retention: none, una página para descargar (ver la guía de artifacts). Si no lo pones, Doconda lo deduce de prompt.

Opciones disponibles:
docx,
pdf,
pptx,
xlsx,
artifact
prompt
string

Qué escribir (al crear) o qué cambiar (al editar). Usa un modelo.

Required string length: 3 - 8000
content
object

Tu propio texto, en Markdown (al crear; en un artifact, el contenido de su página).

style
string

El aspecto, con tus palabras: «títulos azules y centrados, fuente Lora, con portada e índice».

Required string length: 1 - 1000
sources
string · string · object · object[]

Al crear: tus archivos para el documento. Los documentos (Word, PowerPoint, Excel, PDF, también .doc/.ppt/.xls, TXT, Markdown, HTML; hasta 5) son material para escribir, con prompt. Las imágenes (PNG, JPEG, GIF, WebP; hasta 10) van dentro del documento: con prompt, la IA las coloca donde encajan; con content, apunta a ellas desde el Markdown con ![caption](img:1) (la primera imagen de sources). Si prompt pide copiar el aspecto de uno de ellos («con el diseño de nuestra plantilla»), Doconda lo usa como diseño en standard y best (un PowerPoint para una presentación es su plantilla); en fast el documento falla con design_needs_quality, y con quality: "auto" copiar un diseño elige al menos standard (best para todo lo que no sea una plantilla de PowerPoint para una presentación). En un artifact, la página se hace con los datos de los documentos y las imágenes van dentro, reducidas (900 KB como mucho para toda la página).

Maximum array length: 15

Un archivo subido con POST /files.

Pattern: ^file_
file

Al editar: el archivo que quieres cambiar. Word, PowerPoint, Excel o PDF (hasta 50 páginas), también .doc, .ppt y .xls (vuelven como .docx, .pptx y .xlsx).

Pattern: ^file_
quality
enum<string>
predeterminado:auto

Al crear o editar: fast, standard o best (ver niveles de calidad), o auto para que elija Doconda. Cada nivel tiene su precio.

Opciones disponibles:
auto,
fast,
standard,
best
max_quality
enum<string>

Con quality: "auto": el nivel más alto que puede elegir Doconda, para limitar el precio.

Opciones disponibles:
fast,
standard,
best
background
boolean
predeterminado:false

Responde 202 al momento; síguelo con GET, /events o webhooks.

metadata
object
artifact
object

Solo para artifacts. Si no lo pones: shared, o local con retention: none.

retention
enum<string>

Si no lo pones, la retención del proyecto (30 días, salvo que la cambies).

Opciones disponibles:
none,
1d,
7d,
30d,
90d

Respuesta

Modo directo: el documento terminado con sus enlaces de descarga. Con dry_run: DryRunResult.

id
string
requerido
Pattern: ^doc_[0-9A-HJKMNP-TV-Z]{26}$
object
string
requerido
Allowed value: "document"
name
string | null
requerido

El nombre que le diste (name al crearlo).

operation
enum<string>
requerido
Opciones disponibles:
create,
edit
format
enum<string> | null
requerido

El archivo que quieres. docx → Word (y también su PDF), pdf → solo el PDF, pptx → PowerPoint (con su PDF), xlsx → Excel (con su PDF). artifact → una página web que guarda datos (en el navegador de cada visitante, o compartidos por todos), en un enlace firmado; con retention: none, una página para descargar (ver la guía de artifacts). Si no lo pones, Doconda lo deduce de prompt.

Opciones disponibles:
docx,
pdf,
pptx,
xlsx,
artifact
type
enum<string> | null
requerido

Qué es el documento, según decidió Doconda. Fija el aspecto por defecto (un contrato: serif, justificado, cláusulas numeradas; una carta: sin números de página). No lo eliges tú: di lo que quieres en prompt, y el aspecto en style.

Opciones disponibles:
report,
letter,
contract,
memo,
minutes,
presentation,
spreadsheet,
artifact
mode
enum<string> | null
requerido
Opciones disponibles:
prompt,
content
revision
integer
requerido

1 al hacerse; +1 cada vez que se guarda su archivo a mano (PUT /documents/{id}/file). Envíalo al guardar para no pisar los cambios de nadie.

Rango requerido: 1 <= x <= 9007199254740991
status
enum<string>
requerido
Opciones disponibles:
queued,
running,
ready,
failed,
canceled
phase
string | null
requerido
pages
integer | null
requerido
Rango requerido: -9007199254740991 <= x <= 9007199254740991
style_applied
object | null
requerido
error
object | null
requerido
versions
object
requerido
metadata
object
requerido
retention
enum<string>
requerido

Cuánto tiempo guarda Doconda el contenido de un documento (archivos, petición, informe, eventos; la página y los datos de un artifact) después de que termina. none: 15 minutos. Después solo queda lo que necesita la facturación (estado, formato, páginas, coste).

Opciones disponibles:
none,
1d,
7d,
30d,
90d
expires_at
string<date-time> | null
requerido

Cuándo se borrará su contenido: la retention contada desde que terminó o desde el último guardado a mano (con retention: none, desde que terminó).

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
route
object | null
requerido

Cómo se hizo el archivo, y por qué. agent: todos los documentos creados o editados desde el 28 de octubre de 2026, en cualquier calidad. fast: solo documentos anteriores, hechos sin el agente.

quality
object | null
requerido

Al crear y editar: el nivel de calidad pedido y el usado, que es el que fija el precio.

artifact
object | null
requerido

Solo para artifacts: dónde guarda la página sus datos.

content_deleted_at
string<date-time> | null
requerido

Cuándo se borró su contenido: acabó su retención, o se borró.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
created_at
string<date-time>
requerido
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
completed_at
string<date-time> | null
requerido
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
outputs
object[]

Aparece cuando termina.