metadata, and for an
artifact, its page and its data. Only what billing needs stays: status, format, type, pages and cost.
There is no “forever”. To take each document as soon as it finishes, use webhooks.
For a whole project
In the dashboard, Organization → Projects → Kept for. It is the retention of what is created from then on in that project, and also of the files you upload withPOST /files. What already exists keeps its own.
For one document
- It works in
POST /documents. Withoutretention, the project’s is used. Reading a file keeps nothing. - The document carries
retentionandexpires_at: when its content will be deleted (set once it finishes). - Once deleted, the document shows
content_deleted_at, and/reportand/eventsanswer 410content_deleted. - An artifact with
retention: "none"can’t keep shared data: it keeps it in each visitor’s browser, and its page is delivered to download. - If you need it gone sooner, delete it:
DELETE /documents/{id}.