FME Flow: 2024.1

Data Upload Service

You can upload source data or other file-based resources for FME Flow workspaces.

In the FME Flow Web User Interface, file upload is available for any workspace with a published parameter that represents a file used by the workspace. For more information, see Uploading Data Files.

Note  When working with .zip files, we recommend using modern zip utilities that support Unicode file names. If file names are not in Unicode, you can specify the DEFAULT_ZIP_CODEPAGE web application property.

Once data is uploaded, users can select the uploaded data for the workspace to use.

Shelf Life of Uploaded Files

By default, files are deleted one day after they are uploaded. To change, update task Delete_DataUpload_Files on the System Cleanup page of the Web User Interface. For more information, see Cleaning Up FME Flow Logs and Other Files.

Request Elements

Supported Request Methods

The following methods are available for interacting with the Data Upload service. The methods supported for sending files are PUT and POST. The HTTP GET method is supported for browsing files that are already uploaded.

Only volatile storage is supported, and all requests must be associated with an FME Flow workspace.


Request Description

HTTP Method

Target URI

Upload a single file

Upload a file using the HTTP PUT method.



Upload a single file or multiple files

Upload a single file or multiple files using a simple form submission that uses HTTP POST.



Browse Uploaded Files

Get a list of all uploaded files for a session by making a GET request, either to the same URI used to upload files originally, or, in the case of archives, append to this an archive file and/or a file path within the archive for a listing of files there.

Use the optional path component at the end to show the contents of a sub-folder within an archive file. To report just the root contents of the archive file, omit the optional path.


http://host[:port]/fmedataupload/<repository>/<workspace>/<archive file name>/[<filename or path within archive>]

Request Parameters





true | false
Default: false

When enabled, the service response includes the physical or absolute path for each file that the FME Engine can use.

opt_namespace <value>

If specified, uploads are placed in a folder named <value>. If not specified, uploads are placed in a folder named after the name of the uploading user.

Note  If an application uses a single token to connect to FME Flow, we recommend specifying a session identifier, random number, or GUID to distinguish individual uploads and prevent multiple users from uploading files with conflicting filenames to the same repository/workspace location.


This parameter is not available in HTTP GET because extracting archives is an operation and not a state flag.

true | false
Default: false

When enabled, the service extracts uploaded zip files and returns the file contents inside of zip files.
In this case, the file names are logical paths relative to the zip files' container.
For example, a SHAPE file named roads.shp inside of a file is returned as

If false, and the requested path inspects the contents of a zip or archive file, an error response results.

If false, and the requested path is valid, but opt_pathlevel is 2 or higher, a path level of 1 is implied.


xml | json
Default: xml

Defines the language of the response. The text must be all lowercase.


-1 | 0 | n
Default: 1

Specifies how many levels of recursion deep to show file and folder information.
A value of -1 specifies complete recursion as deep as there is.
A value of 0 means do not return any information at all.
Any other positive number denotes the number of levels of recursion. For example, a value of 1 requests only the files in the requested path; that is, only children of the requested path and not descendants.

Response Elements


Child Elements





success | failure

The service status.

file, folder, archive



The name of the file that was uploaded.


long integer

The size in bytes of the file uploaded. The size element does not apply to folders and is absent beneath folder elements.



The absolute or physical path of the file (which is used by an FME Engine).




A session identifier that is always included in the body of the response. The value is the value of the opt_namespace request parameter, if specified, or the name of the uploading user.