---
title: File upload
description: 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.
component: pingidm
version: 8.1
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
keywords: ["REST API", "upload files"]
---

# 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.                                                                                                                                                          |