retention on each request (from none, 15 minutes, to 90d)
or delete them yourself with DELETE /documents/{id} as soon as you download them.
Steps
- Store your API key in
DOCONDA_API_KEYand install the SDK (pip install docondaornpm install @doconda/sdk). - Create the document with the shortest retention that works for you.
- Download it and delete it, along with any files you uploaded.
files.delete(id).
Which values retention accepts
There’s no “forever”. For a whole project, set it in the dashboard; it also applies to files you upload with
POST /files.
What you get back
- The document has
retentionandexpires_at: when its content will be deleted (set when it finishes). - Once deleted, the document shows
content_deleted_at, and/reportand/eventsanswer410 content_deleted. - The files (Word, PDF, images), your request, the report, the events and the
metadataare deleted. Only what’s needed for billing remains: status, format, type, pages and cost.
Limits
- An artifact with
retention: "none"can’t store shared data: it keeps it in each visitor’s browser. - Download links expire after 5 minutes;
documents.outputs(id)gives you new ones while the document exists.
FAQ
Does reading a file to Markdown keep anything?
Does reading a file to Markdown keep anything?
No.
extract has no retention: Doconda keeps nothing once you have the text, and if you
don’t collect it, it’s deleted after 15 minutes.How do I take each document as soon as it's done?
How do I take each document as soon as it's done?
With webhooks: they notify you when it finishes and you download it to your system.
Which API do I use?
Which API do I use?
Every API key (
ak_eu_…) goes to https://api.eu.doconda.com/v1.