For AI agents: this page is also available as Markdown at https://docs.refabric.com/records-and-libraries/retention-and-deletion.md, and the index of every page is https://docs.refabric.com/llms.txt.
Records & libraries
Retention & deletion
What you can delete through the API, what deleting it changes, and what stays.
You can delete the files your jobs produced. Deleting is permanent. How long each kind of data is kept when you do nothing is on Data retention & storage.
How it works
DELETE /v1/files/{ref}deletes one produced file (art:…) of yours, and answers{"file": "art:…", "deleted": true}.- Deletion applies to produced files; other handles (an upload, a record, a library item) answer
422 file_not_deletable. - A handle that is not yours answers
404, as if it did not exist. - A deleted file is permanent.
Delete a produced file
r = s.delete(f"{API}/files/art:x1")
print(r.json()) # {"file": "art:x1", "deleted": true}The same is in Panel › Developers › Files & records, for the kinds that can be deleted.
Deleting is permanent. A url you already received keeps its bytes.
What deleting changes
| Action | Effect | What stays |
|---|---|---|
Delete a produced file (art:…) | GET /v1/files/art:… answers 404 | the job that made or used it keeps its record; its result lists its remaining files |
Delete an upload (file:…) | kept (422 file_not_deletable) | the upload |
| Delete a record or a library item | kept (422 file_not_deletable) | the record or item |
| Delete a job's data | kept | the job |
| Restore a deleted file | — (deleting is permanent) | — |