Files API reference
# Files
Use the section that matches your caller: storefront clients use Shopper REST or Search, trusted services use Management, and signed-in customer flows use Auth.
Use Files when the job is about non-image, non-video assets: uploading a file, reading or updating file metadata, deleting a file, or relating a file to an item.
Files includes trusted Management API operations and a smaller Auth API compatibility surface. Check the API label on the operation before implementing so browser-facing file flows do not get mixed with back-office asset administration.
Use Management DAM routes when the file already exists and only needs folder organization. Use this Files reference when the file record, file content, metadata, or item relationship is the thing being changed.
For workflow guidance across content, assets, saved carts, wishlists, and account context, see [Content, assets, and customer data](/start/concepts/content-assets-and-customer-data).
10 operations grouped by API, then by the job they support.
## Management API · read, create, update, and remove
### Read and inspect
| Operation | API |
| --- | --- |
| [Get File](/reference/files/get-file) | Management API |
| [List Files](/reference/files/list-files) | Management API |
### Create or attach
| Operation | API |
| --- | --- |
| [Add File Relationship](/reference/files/add-file-relationship) | Management API |
| [Upload File](/reference/files/upload-file) | Management API |
### Update or repair
| Operation | API |
| --- | --- |
| [Update File](/reference/files/update-file) | Management API |
### Remove or deactivate
| Operation | API |
| --- | --- |
| [Delete File](/reference/files/delete-file) | Management API |
| [Delete File Relationship](/reference/files/delete-file-relationship) | Management API |
## Auth API · create, update, and remove
### Create or attach
| Operation | API |
| --- | --- |
| [Upload a file](/reference/files/upload-a-file) | Auth API |
### Update or repair
| Operation | API |
| --- | --- |
| [Patch file metadata](/reference/files/patch-file-metadata) | Auth API |
### Remove or deactivate
| Operation | API |
| --- | --- |
| [Delete a file](/reference/files/delete-a-file) | Auth API |