# Files

Endpoints for binary file access. When any of the other APIs return file paths, these file paths are referring to the `path` parameter in the following API's. File paths are unique per organization, but the same path can exist in multiple organizations.


## Upload a file

 - [POST /files/uploads/{path}](https://test-docs.discovery-staging.verifiable.com/references/development/deprecated/api/files/uploadfile.md): Uploads, copies or moves a file. If the file already exists the server returns 409 Conflict.

If x-source-path is set then the file is copied from an existing file and stored at path.
If x-source-delete is set to 1, true or yes then the file is moved instead of copied.
If x-source-path is not set then the content of the file must be uploaded by using form data (Content-Type = multipart/form-data). The new file is stored at path.

Note that there is special handling for files uploaded to uploads/providers/{providerId}/>.>. If this path is used, then the file will be associated with the provider with that identifier and also deleted when this provider gets deleted.
Files must include a > and > to be associated with a provider.

## Upload and overwrite a file

 - [PUT /files/uploads/{path}](https://test-docs.discovery-staging.verifiable.com/references/development/deprecated/api/files/uploadandoverwritefile.md): Uploads, copies or moves a file. If the file already exists then it is overwritten.

If x-source-path is set then the file is copied from an existing file and stored at path.
If x-source-delete is set to 1, true or yes then the file is moved instead of copied.
If x-source-path is not set then the content of the file must be uploaded by using form data (Content-Type = multipart/form-data). The new file is stored at path.

Note that there is special handling for files uploaded to uploads/providers/{providerId}/>.>. If this path is used, then the file will be associated with the provider with that identifier and also deleted when this provider gets deleted.
Files must include a > and > to be associated with a provider.

## Delete a file

 - [DELETE /files/uploads/{pathOrId}](https://test-docs.discovery-staging.verifiable.com/references/development/deprecated/api/files/deletefile.md): Deletes a previously uploaded file.

## Download a file

 - [GET /files/{pathOrId}](https://test-docs.discovery-staging.verifiable.com/references/development/deprecated/api/files/downloadfile.md): Download the file contents for the file at the specified location.

## Get file metadata

 - [HEAD /files/{pathOrId}](https://test-docs.discovery-staging.verifiable.com/references/development/deprecated/api/files/getfilemetadata.md): Returns the metadata of a file at the specified location.

## List uploaded files

 - [GET /files/uploads](https://test-docs.discovery-staging.verifiable.com/references/development/deprecated/api/files/listuploadedfilesmetadata.md): Returns metadata for previously uploaded files.

## List event log exports

 - [GET /files/exports](https://test-docs.discovery-staging.verifiable.com/references/development/deprecated/api/files/listexportfilesmetadata.md): Returns metadata for exported event logs.