Download Managed File or Directory

Obtains an existing file or directory of a specific Managed File ID (or Name) from the File Store.

Request takes no content, and on success returns a response containing the file or directory data (as zipped file).

Request

Method Type:

GET

URI:

/rest/serverengine/filestore/file/{fileId}

Content:
Content Type:

Add. Headers:

If server security settings are enabled, then one of the following:

  • Authorization – Basic Authentication (Username and Password) credentials (Base64 encoded)
  • auth_token – Authorization Token

Parameters

Path

Name Required Type Default Value Description
fileId

The Managed File ID (or Name) of the file or directory in File Store

Response

Success

The following lists status codes indicative of a successful response:

Status Code Content Content-Type Add. Headers Description
200
OK

File

application/octet-stream

Content-Disposition – Filename of the Managed File

Example: "attachment; filename=Promo-EN.OL-datamapper"

File successfully downloaded from File Store.

200
OK

Directory (zipped)

application/zip

Content-Disposition – Filename of the Managed Directory

Example: "attachment; filename=letter-ol.zip"

Directory successfully downloaded from File Store.

Error

The following lists status codes indicative of a failed or error response:

Status Code Content Content-Type Add. Headers Description

401 Unauthorized

WWW-Authenticate – BASIC (Basic Authentication credentials are accepted)

Server authentication is required.

Response when neither basic authentication credentials nor an authorization token have been specified in the request headers.

401 Unauthorized

Error message

Server authentication has failed.

Response when the authorization token specified in the request headers has now expired.

403 Forbidden

Error message

Server authentication has failed.

Response when either the basic authentication credentials or the authorization token specified in the request headers are invalid.

404
Not Found

  • File or directory not found in File Store