---
title: File upload
description: REST endpoints for the PingIDM file upload service to upload, retrieve, and delete files in the repository or filesystem
component: pingidm
version: 7.5
page_id: pingidm:rest-api-reference:endpoints/rest-file-upload
canonical_url: https://docs.pingidentity.com/pingidm/8.1/rest-api-reference/endpoints/rest-file-upload.html
llms_txt: https://docs.pingidentity.com/pingidm/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
keywords: ["REST API", "upload files"]
superseded_by: https://docs.pingidentity.com/pingidm/8.1/rest-api-reference/endpoints/rest-file-upload.html
---

# File upload

IDM supports a generic file upload service at the `file` endpoint. Files are uploaded either to the filesystem or to the repository. For information about configuring this service, and for command-line examples, refer to [Upload files to the server](../../objects-guide/file-upload-service.html).

IDM provides REST access to the file upload service, as listed in the following table:

| URI                                                                 | HTTP Operation | Description                                                                                                                                                                        |
| ------------------------------------------------------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| /openidm/file/handler/                                              | PUT            | Uploads a file to the specified file handler. The file handler is either the repository or the filesystem and the context path is configured in the `conf/file-handler.json` file. |
| /openidm/file/handler/filename                                      | GET            | Returns the file content in a base 64-encoded string within the returned JSON object.                                                                                              |
| /openidm/file/handler/filename?\_fields=content&\_mimeType=mimeType | GET            | Returns the file content with the specified MIME type.                                                                                                                             |
| /openidm/file/handler/filenamemimeType                              | DELETE         | Deletes an uploaded file.                                                                                                                                                          |