Events

• the stream mode of POST /documents;
• reconnecting to or following a document with GET /documents/{id}/events;
• webhooks (final events only; coming soon).

​

Event shape

{
  "id": "evt_01JAB3K9Z4Q8W2M7V6X5T1R0NP",
  "type": "content.block_completed",
  "version": 1,
  "document_id": "doc_01JAB3H8K2M7V6X5T1R0NPQ4ZW",
  "sequence": 14,
  "timestamp": "2026-10-02T09:14:03.512Z",
  "display": { "es": "Escribiendo…", "en": "Writing…" },
  "data": { }
}

​

Types

​

Typical order

document.created → document.started → style.resolved
→ content.block_started → content.block_delta… → content.block_completed   (× each block)
→ render.completed → validation.* → repair.* (if needed)
→ preview.page_ready (× pages) → output.available (Word/PowerPoint/Excel and PDF) → document.ready

• Create from text: the same, but the blocks arrive almost all at once.
• Review: no content.*: render, review, fixes, pages and final.
• Edit: edit.planned, one edit.operation_applied (or _rejected) per change, then the same as review.

​

SSE (stream and /events)

Content-Type: text/event-stream

id: 13
event: content.block_started
data: {"id":"evt_…","type":"content.block_started","sequence":13,…}

: heartbeat

• Reconnect: GET /documents/{id}/events with the header Last-Event-ID: 13 (or ?after=13). First the later stored events are resent (the complete blocks), then it continues live. The document keeps being processed even if the client disconnects.
• Heartbeat (: heartbeat) every 15 s so no proxy cuts the connection.
• After the final event, the server closes the connection.
• Events are kept for 7 days. After that, GET /documents/{id}/events responds 410 events_expired, though the document record is still available.

​

Webhooks (coming soon)

• Same event format. By default only the final ones (document.ready, document.failed, document.canceled). Never events with content.
• Signed per Standard Webhooks: headers webhook-id, webhook-timestamp and webhook-signature (HMAC-SHA256 with a whsec_… secret).
• Retries for ~10 h with increasing delays (5 s, 30 s, 2 min, 10 min, 30 min, 1 h, 3 h, 6 h). The client must deduplicate by webhook-id.
• Public HTTPS URLs only (SSRF protection).