# Upload file

WARNING: The generated curl command is incorrect, so please refer to the Masking API guide for instructions on how to upload files through the API

Endpoint: POST /file-uploads
Version: 5.1.42
Security: api_key

## Query parameters:

  - `permanent` (boolean)
    This indicates whether the file should be persisted permanently. Note that this should be set to true for files like an OAuth settings file, i.e., files that are not explicitly referenced by a JDBC driver, algorithm or driver support plugin, or connection properties file.

## Request fields (multipart/form-data):

  - `file` (string, required)
    The file to be uploaded.

## Response 201 fields (application/json):

  - `fileUuid` (string)
    The unique identifier of the uploaded file. This field is auto-generated by the Masking Engine. This field applies to permanently uploaded files only and can be used to update and delete a permanent file by its ID.

  - `fileReferenceId` (string)
    The reference URI of the uploaded file.
    Example: "delphix-file://upload/f_08bb469a2ddc407bb97a31e96ed0a76a/foo.bar"

  - `filename` (string)
    The name of the file.

  - `fileSize` (number)
    The size in B (bytes) of the uploaded file.

  - `persistenceType` (string)
    The type of persistence of the uploaded file. Temporary/object indicates that the file was either uploaded as a temporary file or as a file associated with a masking object, like a JDBC driver or algorithm plugin.
    Enum: "PERMANENT", "OBJECT/TEMPORARY"


## Response 401 fields

## Response 409 fields