Saltar al contenido principal
POST
Cancelar un documento

Autorizaciones

Authorization
string
header
requerido

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

Parámetros de ruta

document_id
string
requerido

Respuesta

Cancelación pedida (no hace nada si ya terminó).

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.