Skip to main content
Retention is how long Doconda keeps a document’s content after it finishes: 15 minutes, 1, 7, 30 or 90 days. Doconda is not your archive: there is no “forever”, so take each document to your own system before it expires. This is useful for:
  • Keeping sensitive files for minutes instead of a month (none).
  • Giving people time to download or open a document before it goes (7d, 30d).
  • Keeping an artifact online for up to 90 days (90d).

How it works

  1. A document finishes (ready, failed or canceled). Doconda sets expires_at to that moment plus its retention.
  2. Each time a hand-edited file is saved, expires_at is counted again from that save, except with retention: "none".
  3. When expires_at passes, Doconda deletes the content and sets content_deleted_at.
What is deleted: the files (Word, PowerPoint, Excel, PDF, previews), your request, the report, the events and the metadata, and for an artifact, its page and its data. What stays: the document record, without its content. It keeps its name, status, format, type, pages, quality, style_applied, the error if it failed, and the cost. After deletion, GET /documents/{id} still answers, without outputs. /report, /events and /data answer 410 content_deleted.

Configuration

A document uses its own retention if you set one, and otherwise its project’s.

For a whole project

In the dashboard, go to Organization → Projects and change Kept for. Only an owner can change it. It applies to documents created from then on in that project, and to files you upload with POST /files. Documents that already exist keep their own retention.

For one document

In the API, set retention in POST /documents:

Limitations

  • Converting a file doesn’t take retention: a text result is not kept at all, and a file result is deleted 15 minutes after it is made.
  • An artifact with retention: "none" can only keep its data in each visitor’s browser (artifact.storage: "local"), and its page is delivered as a file to download. Asking for shared storage is rejected with 422 retention_none_shared.
  • Events are also kept 7 days at most: after that, /events answers 410 events_expired even with a longer retention.

Delete a document sooner

Call DELETE /documents/{id} (documents.delete() in the SDKs). It deletes the content at once and removes the document: it leaves your lists and GET /documents/{id} answers 404 not_found. A document that is still being made can’t be deleted (409 document_not_finished): cancel it first.
Deleting a document, or reaching its expires_at, can’t be undone. Download what you need first.

Next steps

Receive webhooks

Take each document to your system as soon as it finishes.

Artifacts

How long an artifact’s page and data last.