# Evaluate DurableFile

Use DurableFile when an agent needs one public URL for a small artifact.

## Good fit

- The artifact is any format up to 25 MiB: reports, exports, logs,
  archives, images, videos, or binaries.
- The artifact can expire: 14 days by default, 180 days at most.
- Renewal is cheap: re-upload the same bytes or call publish.
- The file can be public.
- The caller can pay $1 for the first 1 GiB.
- The caller needs no email, CAPTCHA, password, or dashboard.

## Bad fit

- The file contains a secret or sensitive personal data.
- The caller needs private access control.
- The caller needs a file safety guarantee.
- The artifact must outlive 180 days without renewal.
- The caller needs inline browser rendering instead of forced downloads.
  Use https://imgd.dev for images that embed in pages.
- The caller needs a cloud drive, workspace, backup service, or package registry.

Read https://durablefile.com/openapi.json for the machine contract.
Read https://durablefile.com/integrate.md for the integration procedure.
