Data files

Data files represent the flat file storage associated with spaces in your Qlik Cloud tenant. Each space will have a corresponding data files connection, which you can list with data-connections.

Download specification

Endpoints

GET

/v1/data-files
POST

/v1/data-files
GET

/v1/data-files/{id}
PUT

/v1/data-files/{id}
DELETE

/v1/data-files/{id}
POST

/v1/data-files/{id}/actions/change-owner
POST

/v1/data-files/{id}/actions/change-space
POST

/v1/data-files/actions/change-space
POST

/v1/data-files/actions/delete
GET

/v1/data-files/connections
GET

/v1/data-files/connections/{id}
GET

/v1/data-files/quotas

Facts

Rate limit	Tier 1 (1000 requests per minute)
Categories	managebuild

Query Parameters

allowInternalFilesboolean

If set to false, do not return data files with internal extensions else return all the data files.

default = false
appIdstring

Only return files scoped to the specified app. If this parameter is not specified, only files that are not scoped to any app are returned. "*" implies all app-scoped files are returned.
baseNameWildcardstring

If present, return only items whose base name matches the given wildcard. Wildcards include '*' and '?' characters to allow for multiple matches. The base name is the actual file or folder name without any folder pathing included.
connectionIdstring

Return files and folders that reside in the space referenced by the specified DataFiles connection. If this parameter is not specified, the user's personal space is implied.

format = "uuid"
excludeFilesboolean

If set to true, exclude files in the returned list (IE, only return folders). If false, include files.

default = false
excludeSubFoldersboolean

If set to true, exclude folders and files that reside in sub-folders of the root being searched. If false, include all items in full folder hierarchy that recursively reside under the root. That is, setting to true results in only the direct children of the root being returned.

default = false
folderIdstring

If present, return only items which reside under the folder specified by the given ID. If not present, items that live at the root of the space are returned. This property is mutually exclusive with 'folderPath'.

format = "uuid"
folderPathstring

If present, return only items which reside under the specified folder path. If not present, items that live at the root of the space are returned. This property is mutually exclusive with 'folderId'.
includeAllSpacesboolean

If set to true, and connectionId is not specified, return files and folders from all spaces the given user has access to (including the personal space). If connectionId is specified, this parameter is ignored.

default = false
includeFoldersboolean

If set to true, include folders in the returned list. If false, only return data files.

default = false
includeFolderStatsboolean

If set to true, include computed folder statistics for folders in the returned list. If false, this information is not returned.

default = false
limitinteger

If present, the maximum number of data files to return.

minimum = 1, maximum = 1000, default = 20, format = int32, default = 20
namestring

Filter the list of files returned to the given file name.
notOwnerIdstring

If present, fetch the data files whose owner is not the specified owner. If a connectionId is specified in this case, the returned list is constrained to the specified space. If connectionId is not specified, then the returned list is constrained to the calling user's personal space. If includeAllSpaces is set to true, and connectionId is not specified, the returned list is from all spaces the given user has access to (including the personal space).
ownerIdstring

If present, fetch the data files for the specified owner. If a connectionId is specified in this case, the returned list is constrained to the specified space. If connectionId is not specified, then all files owned by the specified user are returned regardless of the personal space that a given file resides in.
pagestring

If present, the cursor that starts the page of data that is returned.
sortstring

The name of the field used to sort the result. By default, the sort order is ascending. Putting a '+' prefix on the sort field name explicitly indicates ascending sort order. A '-' prefix indicates a descending sort order.

Can be one of: "name""+name""-name""size""+size""-size""modifiedDate""+modifiedDate""-modifiedDate""folder""+folder""-folder""baseName""+baseName""-baseName"

Responses

200

application/json

The file list was retrieved.

application/jsonobject
Show application/json properties
- dataarray of objects
  Required
  
  Properties of the uploaded data files.
  
  Show data properties
  
  idstring
  Required
  
  The ID for the file or folder.
  
  format = "uuid"
  
  qristring
  
  The QRI generated from the datafile or folder's metadata.
  
  namestring
  Required
  
  The full name of the file or folder, including any folder path prefix.
  
  sizeinteger
  Required
  
  The size of the uploaded file, in bytes. 0 if this item represents a folder
  
  format = int64
  
  appIdstring
  
  If this file or folder is bound to the lifecycle of a specific app, this is the ID of this app.
  
  folderboolean
  
  Whether or not this given item represents a folder or a file.
  
  actionsarray of strings
  Required
  
  The CRUD actions that are allowed on the given data file.
  
  Values may be any of: "read""update""delete""list""change_owner""change_space"
  
  ownerIdstring
  Required
  
  The 'owner' of a file or folder is the user who last uploaded the item's content.
  
  spaceIdstring
  
  If the file or folder was created in a team space, this is the ID of that space.
  
  baseNamestring
  
  The name of the file or folder, not including any folder path prefix.
  
  folderIdstring
  
  If the file or folder resides in a parent folder, this is the parent folder ID. If the file or folder does not reside in a parent folder, this value is null.
  
  format = "uuid"
  
  folderPathstring
  
  If the file or folder resides in a parent folder, this is the parent folder path. If the file or folder does not reside in a parent folder, this value is null.
  
  createdDatestring
  Required
  
  The date that the file or folder was created.
  
  format = "date-time"
  
  folderStatsobject
  Required
  
  Show folderStats properties
  
  totalFileCountinteger
  Required
  
  The number of data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directFileCountinteger
  Required
  
  The number of data files that reside as direct children of the given folder.
  
  format = int64
  
  totalFolderCountinteger
  Required
  
  The number of folders that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  aggregateFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directFolderCountinteger
  Required
  
  The number of sub-folders that reside as direct children of the given folder.
  
  format = int64
  
  totalInternalFileCountinteger
  Required
  
  The number of 'internal' data files (IE, those that are not visible to end users by default) that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directInternalFileCountinteger
  Required
  
  The number of 'internal' data files (IE, those that are not visible to end users by default) that reside as direct children of the given folder.
  
  format = int64
  
  totalAppScopedFileCountinteger
  Required
  
  The number of app-scoped data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directAppScopedFileCountinteger
  Required
  
  The number of app-scoped data files that reside as direct children of the given folder.
  
  format = int64
  
  aggregateInternalFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all internal data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  aggregateAppScopedFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all app-scoped data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  modifiedDatestring
  
  The date that the updated file or folder was last modified.
  
  format = "date-time"
- linksobject
  Required
  
  Show links properties
  
  nextobject
  Required
  
  Show next properties
  
  hrefstring
  
  The URL for the link.
  
  format = "uri"
  
  prevobject
  Required
  
  Show prev properties
  
  hrefstring
  
  The URL for the link.
  
  format = "uri"
  
  selfobject
  Required
  
  Show self properties
  
  hrefstring
  
  The URL for the link.
  
  format = "uri"

400

application/json

Bad Request

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

403

application/json

Forbidden

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

GET /v1/data-files

curl "https://your-tenant.us.qlikcloud.com/api/v1/data-files" \
-H "Authorization: Bearer <access_token>"

const https = require('https')
  const data = JSON.stringify("")
  const options =   {
    'hostname': 'https://your-tenant.us.qlikcloud.com',
    'port': 443,
    'path': '/api/v1/data-files',
    'method': 'GET',
    'headers': {
      'Authorization': 'Bearer <access_token>'
    }
  }
  const req = https.request(options)

qlik data-file ls

Response

{
  "data": [
    {
      "id": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc",
      "qri": "qri:qdf:space://ooSOGoLLaq7EMaSdSsCiGvLwcd_VAf1oU0mzwSfp_Qs#wME89c8gKu_Tpz8W_a0JKSbKC4hzbNu0NLVgqi2UFS0",
      "name": "some/folder/MyFile.csv",
      "size": 1024,
      "appId": "f34b91a1-0dc3-44ac-a847-51cb84122c84",
      "folder": true,
      "actions": [
        "read"
      ],
      "ownerId": "lDL4DIINndhL_iJkcbqWyJenuwizP-2D",
      "spaceId": "617979737a9f56e49dea2e6e",
      "baseName": "MyFile.csv",
      "folderId": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc",
      "folderPath": "some/folder",
      "createdDate": "2020-07-07T20:52:40.8534780Z",
      "folderStats": {
        "totalFileCount": 50,
        "directFileCount": 50,
        "totalFolderCount": 50,
        "aggregateFileSize": 10000,
        "directFolderCount": 50,
        "totalInternalFileCount": 50,
        "directInternalFileCount": 50,
        "totalAppScopedFileCount": 50,
        "directAppScopedFileCount": 50,
        "aggregateInternalFileSize": 10000,
        "aggregateAppScopedFileSize": 10000
      },
      "modifiedDate": "2020-07-07T20:52:40.8534780Z"
    }
  ],
  "links": {
    "next": {
      "href": "string"
    },
    "prev": {
      "href": "string"
    },
    "self": {
      "href": "string"
    }
  }
}

Facts

Rate limit	Tier 2 (100 requests per minute)
Categories	managebuild

Request Body

multipart/form-data

multipart/form-dataobject
Show multipart/form-data properties
- Filestring
  
  IFormFile form multipart/form-data
  
  format = "binary"
- Jsonobject
  
  See PostDataFileRequest schema which defines request structure. See model.
  
  Show Json properties
  
  namestring
  Required
  
  Name that will be given to the file or folder. It should be noted that the '/' character in the name indicates a 'path' separator in a logical folder hierarchy for the name. Names that contain '/'s should be used with the assumption that a logical 'folder hierarchy' is being defined for the full pathname of that file or folder. IE, a '/' is a significant character in the name.
  
  pattern = "^[^<>":\u0000|?*]+$"
  
  appIdstring
  
  If this file should be bound to the lifecycle of a specific app, this is the ID of this app. If this request is creating a folder, the specification of an app ID is not allowed.
  
  folderboolean
  
  If true, a folder will be created. If false, a file is created.
  
  default = false
  
  folderIdstring
  
  If the specified file or folder should be moved to become a a sub-item of an existing folder, this is the ID of this parent folder. Any additional folder path that is present on the Name property will be created as a subfolder hierarchy of this folder. If the FolderID is null, the file or folder specified in the Name property (including any folder prefix on that name), will be created in the root of the space.
  
  format = "uuid"
  
  sourceIdstring
  
  If a SourceId is specified, this is the ID of the existing data file or folder whose content should be copied into the specified data file or folder. That is, for a file instead of the file content being specified in the Data element, it is effectively copied from an existing, previously uploaded file. For a folder, rather than the new folder being empty, it's contents are copied from an existing, previously created folder.
  
  format = "uuid"
  
  connectionIdstring
  
  If present, this is the DataFiles connection that the upload should occur in the context of. If absent, the default is that the upload will occur in the context of the Personal Space DataFiles connection. If the DataFiles connection is different from the one specified when the file or folder was last POSTed or PUT, this will result in a logical move of this file or folder into the new space.
  
  format = "uuid"
  
  tempContentFileIdstring
  
  If a TempContentFileId is specified, this is the ID of a previously uploaded temporary content file whose content should be copied into the specified data file. That is, instead of the file content being specified in the Data element, it is effectively copied from an existing, previously uploaded file. The expectation is that this file was previously uploaded to the temporary content service, and the ID specified here is the one returned from the temp content upload request. This option does not apply when POSTing a folder.

Responses

201

application/json

New file or folder was created.

application/jsonobject
Show application/json properties
- idstring
  Required
  
  The ID for the file or folder.
  
  format = "uuid"
- qristring
  
  The QRI generated from the datafile or folder's metadata.
- namestring
  Required
  
  The full name of the file or folder, including any folder path prefix.
- sizeinteger
  Required
  
  The size of the uploaded file, in bytes. 0 if this item represents a folder
  
  format = int64
- appIdstring
  
  If this file or folder is bound to the lifecycle of a specific app, this is the ID of this app.
- folderboolean
  
  Whether or not this given item represents a folder or a file.
- actionsarray of strings
  Required
  
  The CRUD actions that are allowed on the given data file.
  
  Values may be any of: "read""update""delete""list""change_owner""change_space"
- ownerIdstring
  Required
  
  The 'owner' of a file or folder is the user who last uploaded the item's content.
- spaceIdstring
  
  If the file or folder was created in a team space, this is the ID of that space.
- baseNamestring
  
  The name of the file or folder, not including any folder path prefix.
- folderIdstring
  
  If the file or folder resides in a parent folder, this is the parent folder ID. If the file or folder does not reside in a parent folder, this value is null.
  
  format = "uuid"
- folderPathstring
  
  If the file or folder resides in a parent folder, this is the parent folder path. If the file or folder does not reside in a parent folder, this value is null.
- createdDatestring
  Required
  
  The date that the file or folder was created.
  
  format = "date-time"
- folderStatsobject
  Required
  
  Show folderStats properties
  
  totalFileCountinteger
  Required
  
  The number of data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directFileCountinteger
  Required
  
  The number of data files that reside as direct children of the given folder.
  
  format = int64
  
  totalFolderCountinteger
  Required
  
  The number of folders that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  aggregateFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directFolderCountinteger
  Required
  
  The number of sub-folders that reside as direct children of the given folder.
  
  format = int64
  
  totalInternalFileCountinteger
  Required
  
  The number of 'internal' data files (IE, those that are not visible to end users by default) that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directInternalFileCountinteger
  Required
  
  The number of 'internal' data files (IE, those that are not visible to end users by default) that reside as direct children of the given folder.
  
  format = int64
  
  totalAppScopedFileCountinteger
  Required
  
  The number of app-scoped data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directAppScopedFileCountinteger
  Required
  
  The number of app-scoped data files that reside as direct children of the given folder.
  
  format = int64
  
  aggregateInternalFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all internal data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  aggregateAppScopedFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all app-scoped data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
- modifiedDatestring
  
  The date that the updated file or folder was last modified.
  
  format = "date-time"

400

application/json

Bad Request

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

403

application/json

Forbidden

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

409

application/json

A file or folder with the same name already exists in the specified user or app scope.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

413

application/json

The file exceeds the user's quota for maximum file size to upload.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

423

application/json

The file is already locked for read or write by another client.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

501

application/json

Not Implemented

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

POST /v1/data-files

curl "https://your-tenant.us.qlikcloud.com/api/v1/data-files" \
-X POST \
-H "Content-type: multipart/form-data" \
-H "Authorization: Bearer <access_token>" \
-F "File=@/path/to/file" \
-F "Json={\"name\":\"some/folder/MyFile.csv\",\"appId\":\"f34b91a1-0dc3-44ac-a847-51cb84122c84\",\"folder\":false,\"folderId\":\"c35f4b70-3ce4-4a30-b62b-2aef16943bc4\",\"sourceId\":\"f34b91a1-0dc3-44ac-a847-51cb84122c84\",\"connectionId\":\"ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc\",\"tempContentFileId\":\"624b0f54459f1c00018dade4\"}"

const https = require('https')
  const data = JSON.stringify({"File":"string","Json":{"name":"some/folder/MyFile.csv","appId":"f34b91a1-0dc3-44ac-a847-51cb84122c84","folder":false,"folderId":"c35f4b70-3ce4-4a30-b62b-2aef16943bc4","sourceId":"f34b91a1-0dc3-44ac-a847-51cb84122c84","connectionId":"ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc","tempContentFileId":"624b0f54459f1c00018dade4"}})
  const options =   {
    'hostname': 'https://your-tenant.us.qlikcloud.com',
    'port': 443,
    'path': '/api/v1/data-files',
    'method': 'POST',
    'headers': {
      'Content-type': 'multipart/form-data',
      'Authorization': 'Bearer <access_token>'
    }
  }
  const req = https.request(options)
  req.write(formData)

qlik data-file create

Request

{
  "File": "string",
  "Json": {
    "name": "some/folder/MyFile.csv",
    "appId": "f34b91a1-0dc3-44ac-a847-51cb84122c84",
    "folder": false,
    "folderId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4",
    "sourceId": "f34b91a1-0dc3-44ac-a847-51cb84122c84",
    "connectionId": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc",
    "tempContentFileId": "624b0f54459f1c00018dade4"
  }
}

Response

{
  "id": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc",
  "qri": "qri:qdf:space://ooSOGoLLaq7EMaSdSsCiGvLwcd_VAf1oU0mzwSfp_Qs#wME89c8gKu_Tpz8W_a0JKSbKC4hzbNu0NLVgqi2UFS0",
  "name": "some/folder/MyFile.csv",
  "size": 1024,
  "appId": "f34b91a1-0dc3-44ac-a847-51cb84122c84",
  "folder": true,
  "actions": [
    "read"
  ],
  "ownerId": "lDL4DIINndhL_iJkcbqWyJenuwizP-2D",
  "spaceId": "617979737a9f56e49dea2e6e",
  "baseName": "MyFile.csv",
  "folderId": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc",
  "folderPath": "some/folder",
  "createdDate": "2020-07-07T20:52:40.8534780Z",
  "folderStats": {
    "totalFileCount": 50,
    "directFileCount": 50,
    "totalFolderCount": 50,
    "aggregateFileSize": 10000,
    "directFolderCount": 50,
    "totalInternalFileCount": 50,
    "directInternalFileCount": 50,
    "totalAppScopedFileCount": 50,
    "directAppScopedFileCount": 50,
    "aggregateInternalFileSize": 10000,
    "aggregateAppScopedFileSize": 10000
  },
  "modifiedDate": "2020-07-07T20:52:40.8534780Z"
}

Facts

Rate limit	Tier 1 (1000 requests per minute)
Categories	managebuild

Path Parameters

idstring
Required

The ID of the data file.

format = "uuid"

Responses

200

application/json

The file was located.

application/jsonobject
Show application/json properties
- idstring
  Required
  
  The ID for the file or folder.
  
  format = "uuid"
- qristring
  
  The QRI generated from the datafile or folder's metadata.
- namestring
  Required
  
  The full name of the file or folder, including any folder path prefix.
- sizeinteger
  Required
  
  The size of the uploaded file, in bytes. 0 if this item represents a folder
  
  format = int64
- appIdstring
  
  If this file or folder is bound to the lifecycle of a specific app, this is the ID of this app.
- folderboolean
  
  Whether or not this given item represents a folder or a file.
- actionsarray of strings
  Required
  
  The CRUD actions that are allowed on the given data file.
  
  Values may be any of: "read""update""delete""list""change_owner""change_space"
- ownerIdstring
  Required
  
  The 'owner' of a file or folder is the user who last uploaded the item's content.
- spaceIdstring
  
  If the file or folder was created in a team space, this is the ID of that space.
- baseNamestring
  
  The name of the file or folder, not including any folder path prefix.
- folderIdstring
  
  If the file or folder resides in a parent folder, this is the parent folder ID. If the file or folder does not reside in a parent folder, this value is null.
  
  format = "uuid"
- folderPathstring
  
  If the file or folder resides in a parent folder, this is the parent folder path. If the file or folder does not reside in a parent folder, this value is null.
- createdDatestring
  Required
  
  The date that the file or folder was created.
  
  format = "date-time"
- folderStatsobject
  Required
  
  Show folderStats properties
  
  totalFileCountinteger
  Required
  
  The number of data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directFileCountinteger
  Required
  
  The number of data files that reside as direct children of the given folder.
  
  format = int64
  
  totalFolderCountinteger
  Required
  
  The number of folders that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  aggregateFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directFolderCountinteger
  Required
  
  The number of sub-folders that reside as direct children of the given folder.
  
  format = int64
  
  totalInternalFileCountinteger
  Required
  
  The number of 'internal' data files (IE, those that are not visible to end users by default) that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directInternalFileCountinteger
  Required
  
  The number of 'internal' data files (IE, those that are not visible to end users by default) that reside as direct children of the given folder.
  
  format = int64
  
  totalAppScopedFileCountinteger
  Required
  
  The number of app-scoped data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directAppScopedFileCountinteger
  Required
  
  The number of app-scoped data files that reside as direct children of the given folder.
  
  format = int64
  
  aggregateInternalFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all internal data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  aggregateAppScopedFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all app-scoped data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
- modifiedDatestring
  
  The date that the updated file or folder was last modified.
  
  format = "date-time"

400

application/json

Bad Request

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

403

application/json

Forbidden

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

404

application/json

A data file with the specified ID was not found.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

GET /v1/data-files/{id}

curl "https://your-tenant.us.qlikcloud.com/api/v1/data-files/{id}" \
-H "Authorization: Bearer <access_token>"

const https = require('https')
  const data = JSON.stringify("")
  const options =   {
    'hostname': 'https://your-tenant.us.qlikcloud.com',
    'port': 443,
    'path': '/api/v1/data-files/{id}',
    'method': 'GET',
    'headers': {
      'Authorization': 'Bearer <access_token>'
    }
  }
  const req = https.request(options)

qlik data-file get <data-fileId>

Response

{
  "id": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc",
  "qri": "qri:qdf:space://ooSOGoLLaq7EMaSdSsCiGvLwcd_VAf1oU0mzwSfp_Qs#wME89c8gKu_Tpz8W_a0JKSbKC4hzbNu0NLVgqi2UFS0",
  "name": "some/folder/MyFile.csv",
  "size": 1024,
  "appId": "f34b91a1-0dc3-44ac-a847-51cb84122c84",
  "folder": true,
  "actions": [
    "read"
  ],
  "ownerId": "lDL4DIINndhL_iJkcbqWyJenuwizP-2D",
  "spaceId": "617979737a9f56e49dea2e6e",
  "baseName": "MyFile.csv",
  "folderId": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc",
  "folderPath": "some/folder",
  "createdDate": "2020-07-07T20:52:40.8534780Z",
  "folderStats": {
    "totalFileCount": 50,
    "directFileCount": 50,
    "totalFolderCount": 50,
    "aggregateFileSize": 10000,
    "directFolderCount": 50,
    "totalInternalFileCount": 50,
    "directInternalFileCount": 50,
    "totalAppScopedFileCount": 50,
    "directAppScopedFileCount": 50,
    "aggregateInternalFileSize": 10000,
    "aggregateAppScopedFileSize": 10000
  },
  "modifiedDate": "2020-07-07T20:52:40.8534780Z"
}

Facts

Rate limit	Special (800 requests per minute)
Categories	managebuild

Path Parameters

idstring
Required

The ID of the data file to update.

format = "uuid"

Request Body

multipart/form-data

multipart/form-dataobject
Show multipart/form-data properties
- Filestring
  
  IFormFile form multipart/form-data
  
  format = "binary"
- Jsonobject
  
  See PutDataFileRequest schema which defines request structure. See model.
  
  Show Json properties
  
  namestring
  
  Name that will be given to the file or folder. If this name is different than the name used when the file or folder was last POSTed or PUT, this will result in a rename of the file or folder. It should be noted that the '/' character in a data file name indicates a 'path' separator in a logical folder hierarchy for the name. Names that contain '/'s should be used with the assumption that a logical 'folder hierarchy' is being defined for the full pathname of that file or folder.. '/' is a significant character in the data file or folder name.
  
  pattern = "^[^<>":\u0000|?*]+$"
  
  appIdstring
  
  If this file should be bound to the lifecycle of a specific app, this is the ID of this app. If this request is creating a folder, the specification of an app ID is not allowed.
  
  folderIdstring
  
  If the specified file or folder should be created as a sub-item of an existing folder, this is the ID of this parent folder. Any additional folder path that is present on the Name property will be created as a subfolder hierarchy of this folder. If the FolderID is null, the file or folder specified in the Name property (including any folder prefix on that name), will be created in the root of the space.
  
  format = "uuid"
  
  sourceIdstring
  
  If a SourceId is specified, this is the ID of the existing data file or folder whose content should be copied into the specified data file or folder. That is, for a file instead of the file content being specified in the Data element, it is effectively copied from an existing, previously uploaded file. For a folder, it's contents are copied from an existing, previously created folder. If there it existing content in the target folder, then how the source and target folder contents are merged together is specified in the FolderMergeBehavior option.
  
  format = "uuid"
  
  connectionIdstring
  
  If present, this is the DataFiles connection points to the space that the file or folder should reside in. If absent, the default is that the file or folder will reside in the Personal SPce. If the DataFiles connection is different from the one specified when the file or folder was last POSTed or PUT, this will result in a logical move of this file or folder into the new space.
  
  format = "uuid"
  
  tempContentFileIdstring
  
  If a TempContentFileId is specified, this is the ID of a previously uploaded temporary content file whose content should be copied into the specified data file. That is, instead of the file content being specified in the Data element, it is effectively copied from an existing, previously uploaded file. The expectation is that this file was previously uploaded to the temporary content service, and the ID specified here is the one returned from the temp content upload request.
  
  folderMergeBehaviorstring
  
  If a SourceId is specified, and a folder is being updated by this PUT operation, this specifies how the source folder contents should be applied to the target folder, if the target folder is not empty. 'merge' implies the contents of the source folder should be merged with the existing target contents. That is, all existing direct or indirect child items in the target folder are replaced by the same items in the source folder. All existing items in the target folder that are not present in the source folder are left, as is, in the target. 'replace' implies the contents of the source folder should replace the contents of the target folder. That is, all direct or indirect items in the target folder are removed before the items from the source folder are copied over. The resulting target folder only contains the items from the source folder. If not specified, the default behavior is 'merge'.
  Members:
  
  Can be one of: "merge""replace"

Responses

201

application/json

The file or folder was updated.

application/jsonobject
Show application/json properties
- idstring
  Required
  
  The ID for the file or folder.
  
  format = "uuid"
- qristring
  
  The QRI generated from the datafile or folder's metadata.
- namestring
  Required
  
  The full name of the file or folder, including any folder path prefix.
- sizeinteger
  Required
  
  The size of the uploaded file, in bytes. 0 if this item represents a folder
  
  format = int64
- appIdstring
  
  If this file or folder is bound to the lifecycle of a specific app, this is the ID of this app.
- folderboolean
  
  Whether or not this given item represents a folder or a file.
- actionsarray of strings
  Required
  
  The CRUD actions that are allowed on the given data file.
  
  Values may be any of: "read""update""delete""list""change_owner""change_space"
- ownerIdstring
  Required
  
  The 'owner' of a file or folder is the user who last uploaded the item's content.
- spaceIdstring
  
  If the file or folder was created in a team space, this is the ID of that space.
- baseNamestring
  
  The name of the file or folder, not including any folder path prefix.
- folderIdstring
  
  If the file or folder resides in a parent folder, this is the parent folder ID. If the file or folder does not reside in a parent folder, this value is null.
  
  format = "uuid"
- folderPathstring
  
  If the file or folder resides in a parent folder, this is the parent folder path. If the file or folder does not reside in a parent folder, this value is null.
- createdDatestring
  Required
  
  The date that the file or folder was created.
  
  format = "date-time"
- folderStatsobject
  Required
  
  Show folderStats properties
  
  totalFileCountinteger
  Required
  
  The number of data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directFileCountinteger
  Required
  
  The number of data files that reside as direct children of the given folder.
  
  format = int64
  
  totalFolderCountinteger
  Required
  
  The number of folders that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  aggregateFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directFolderCountinteger
  Required
  
  The number of sub-folders that reside as direct children of the given folder.
  
  format = int64
  
  totalInternalFileCountinteger
  Required
  
  The number of 'internal' data files (IE, those that are not visible to end users by default) that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directInternalFileCountinteger
  Required
  
  The number of 'internal' data files (IE, those that are not visible to end users by default) that reside as direct children of the given folder.
  
  format = int64
  
  totalAppScopedFileCountinteger
  Required
  
  The number of app-scoped data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directAppScopedFileCountinteger
  Required
  
  The number of app-scoped data files that reside as direct children of the given folder.
  
  format = int64
  
  aggregateInternalFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all internal data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  aggregateAppScopedFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all app-scoped data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
- modifiedDatestring
  
  The date that the updated file or folder was last modified.
  
  format = "date-time"

400

application/json

Bad Request

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

403

application/json

Forbidden

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

404

application/json

A data file or folder with the specified ID was not found.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

409

application/json

If the file or folder was renamed during the update, a file or folder with the new name already exists. Also, if the space that the file or folder resides in was changed as part of the update, a file or folder with the same name already resides in the new space.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

413

application/json

The file exceeds the user's quota for maximum file size to upload.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

423

application/json

The file is already locked for read or write by another client. If a folder is being updated, then if any file or folder in the subfolder hierarchy of this folder is already locked for write.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

PUT /v1/data-files/{id}

curl "https://your-tenant.us.qlikcloud.com/api/v1/data-files/{id}" \
-X PUT \
-H "Content-type: multipart/form-data" \
-H "Authorization: Bearer <access_token>" \
-F "File=@/path/to/file" \
-F "Json={\"name\":\"some/folder/MyFile.csv\",\"appId\":\"f34b91a1-0dc3-44ac-a847-51cb84122c84\",\"folderId\":\"ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc\",\"sourceId\":\"f34b91a1-0dc3-44ac-a847-51cb84122c84\",\"connectionId\":\"ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc\",\"tempContentFileId\":\"624b0f54459f1c00018dade4\",\"folderMergeBehavior\":\"merge\"}"

const https = require('https')
  const data = JSON.stringify({"File":"string","Json":{"name":"some/folder/MyFile.csv","appId":"f34b91a1-0dc3-44ac-a847-51cb84122c84","folderId":"ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc","sourceId":"f34b91a1-0dc3-44ac-a847-51cb84122c84","connectionId":"ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc","tempContentFileId":"624b0f54459f1c00018dade4","folderMergeBehavior":"merge"}})
  const options =   {
    'hostname': 'https://your-tenant.us.qlikcloud.com',
    'port': 443,
    'path': '/api/v1/data-files/{id}',
    'method': 'PUT',
    'headers': {
      'Content-type': 'multipart/form-data',
      'Authorization': 'Bearer <access_token>'
    }
  }
  const req = https.request(options)
  req.write(formData)

qlik data-file update <data-fileId>

Request

{
  "File": "string",
  "Json": {
    "name": "some/folder/MyFile.csv",
    "appId": "f34b91a1-0dc3-44ac-a847-51cb84122c84",
    "folderId": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc",
    "sourceId": "f34b91a1-0dc3-44ac-a847-51cb84122c84",
    "connectionId": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc",
    "tempContentFileId": "624b0f54459f1c00018dade4",
    "folderMergeBehavior": "merge"
  }
}

Response

{
  "id": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc",
  "qri": "qri:qdf:space://ooSOGoLLaq7EMaSdSsCiGvLwcd_VAf1oU0mzwSfp_Qs#wME89c8gKu_Tpz8W_a0JKSbKC4hzbNu0NLVgqi2UFS0",
  "name": "some/folder/MyFile.csv",
  "size": 1024,
  "appId": "f34b91a1-0dc3-44ac-a847-51cb84122c84",
  "folder": true,
  "actions": [
    "read"
  ],
  "ownerId": "lDL4DIINndhL_iJkcbqWyJenuwizP-2D",
  "spaceId": "617979737a9f56e49dea2e6e",
  "baseName": "MyFile.csv",
  "folderId": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc",
  "folderPath": "some/folder",
  "createdDate": "2020-07-07T20:52:40.8534780Z",
  "folderStats": {
    "totalFileCount": 50,
    "directFileCount": 50,
    "totalFolderCount": 50,
    "aggregateFileSize": 10000,
    "directFolderCount": 50,
    "totalInternalFileCount": 50,
    "directInternalFileCount": 50,
    "totalAppScopedFileCount": 50,
    "directAppScopedFileCount": 50,
    "aggregateInternalFileSize": 10000,
    "aggregateAppScopedFileSize": 10000
  },
  "modifiedDate": "2020-07-07T20:52:40.8534780Z"
}

Facts

Rate limit	Tier 2 (100 requests per minute)
Categories	managebuild

Path Parameters

idstring
Required

The ID of the data file or folder to delete.

format = "uuid"

Responses

204

The file or folder was deleted.

400

application/json

Bad Request

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

403

application/json

Forbidden

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

404

application/json

A data file or folder with the specified ID was not found.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

DELETE /v1/data-files/{id}

curl "https://your-tenant.us.qlikcloud.com/api/v1/data-files/{id}" \
-X DELETE \
-H "Authorization: Bearer <access_token>"

const https = require('https')
  const data = JSON.stringify("")
  const options =   {
    'hostname': 'https://your-tenant.us.qlikcloud.com',
    'port': 443,
    'path': '/api/v1/data-files/{id}',
    'method': 'DELETE',
    'headers': {
      'Authorization': 'Bearer <access_token>'
    }
  }
  const req = https.request(options)

qlik data-file rm <data-fileId>

This is primarily an admin type of operation. In general, the owner of a data file or folder is implicitly set as part of a create or update operation. For data files or folders that reside in a personal space, changing the owner has the effect of moving the data file to the new owner's personal space. Note that, If a given file or folder is not in the root of a personal space, this operation will not succeed, since the parent folder does not reside in the target owner's personal space. If the owner of a folder in the root of a personal space is changed, the owner of all subfolders and files within those subfolders will also recursively change.

Facts

Rate limit	Tier 2 (100 requests per minute)
Categories	managebuild

Path Parameters

idstring
Required

The ID of the data file or folder whose owner will be updated.

format = "uuid"

Request Body

application/json

The request.

application/jsonobject
Show application/json properties
- ownerIdstring
  Required
  
  The ID of the new owner.

Responses

204

The file or folder's owner was changed.

400

application/json

An owner with the specified ID does not exist.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

403

application/json

The user does not have permission to modify the specified data file or folder, or if the item does not reside in the root of the space.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

404

application/json

A data file or folder with the specified ID was not found.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

409

application/json

If the file or folder is in a personal space, and the personal space of the new owner already has an item in the space with the same name as the item being moved.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

423

application/json

The file or folder is already locked for write by another client. For folders, any write lock on a subfolder or file underneath this folder implies a lock on the folder.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

POST /v1/data-files/{id}/actions/change-owner

curl "https://your-tenant.us.qlikcloud.com/api/v1/data-files/{id}/actions/change-owner" \
-X POST \
-H "Content-type: application/json" \
-H "Authorization: Bearer <access_token>" \
-d '{"ownerId":"lDL4DIINndhL_iJkcbqWyJenuwizP-2D"}'

const https = require('https')
  const data = JSON.stringify({"ownerId":"lDL4DIINndhL_iJkcbqWyJenuwizP-2D"})
  const options =   {
    'hostname': 'https://your-tenant.us.qlikcloud.com',
    'port': 443,
    'path': '/api/v1/data-files/{id}/actions/change-owner',
    'method': 'POST',
    'headers': {
      'Content-type': 'application/json',
      'Authorization': 'Bearer <access_token>'
    }
  }
  const req = https.request(options)
  req.write(data)

qlik data-file change-owner <data-fileId> \
--ownerId="lDL4DIINndhL_iJkcbqWyJenuwizP-2D"

Request

{
  "ownerId": "lDL4DIINndhL_iJkcbqWyJenuwizP-2D"
}

This is to allow for a separate admin type of operation that is more global in terms of access in cases where admin users may not explicitly have been granted full access to a given space within the declared space-level permissions. If the space ID is set to null, then the datafile or folder will end up residing in the personal space of the user who is the owner of the item. Note that, if a given file or folder is not in the root of a given space, this operation will not succeed, since the parent folder does not reside in the target space. If the space of a folder in the root of the source space is changed, all subfolders and files within those subfolders will also recursively be moved to the new space.

Facts

Rate limit	Tier 2 (100 requests per minute)
Categories	managebuild

Path Parameters

idstring
Required

The ID of the data file or folder whose space will be updated.

format = "uuid"

Request Body

application/json

The request.

application/jsonobject
Show application/json properties
- spaceIdstring
  
  The ID of the space. If null, this data file will be moved to the user's personal space.

Responses

204

The file or folder's space was changed.

400

application/json

A space with the specified ID does not exist.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

403

application/json

The user does not have permission to modify the specified data file or folder, or if the item does not reside in the root of the space.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

404

application/json

A data file or folder with the specified ID was not found.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

409

application/json

If there is a file or folder in the target space with the same name as the item being moved.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

423

application/json

The file is already locked for write by another client. For folders, any write lock on a subfolder or file underneath this folder implies a lock on the folder.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

POST /v1/data-files/{id}/actions/change-space

curl "https://your-tenant.us.qlikcloud.com/api/v1/data-files/{id}/actions/change-space" \
-X POST \
-H "Content-type: application/json" \
-H "Authorization: Bearer <access_token>" \
-d '{"spaceId":"617979737a9f56e49dea2e6e"}'

const https = require('https')
  const data = JSON.stringify({"spaceId":"617979737a9f56e49dea2e6e"})
  const options =   {
    'hostname': 'https://your-tenant.us.qlikcloud.com',
    'port': 443,
    'path': '/api/v1/data-files/{id}/actions/change-space',
    'method': 'POST',
    'headers': {
      'Content-type': 'application/json',
      'Authorization': 'Bearer <access_token>'
    }
  }
  const req = https.request(options)
  req.write(data)

qlik data-file change-space <data-fileId> \
--spaceId="617979737a9f56e49dea2e6e"

Request

{
  "spaceId": "617979737a9f56e49dea2e6e"
}

Facts

Rate limit	Tier 2 (100 requests per minute)
Categories	managebuild

Request Body

application/json

The batch of IDs for each data file in the batch whose space will be changed along with the space IDs for each change.

Specifies the list of data file change space operations in a single batch.

application/jsonobject

Specifies the list of data file change space operations in a single batch.
Show application/json properties
- change-spacearray of objects
  Required
  
  The list of data files to delete.
  
  Show change-space properties
  
  idstring
  Required
  
  The ID of the data file whose space will be changed.
  
  format = "uuid"
  
  spaceIdstring
  
  The ID of the new space. Passing in a null will result in the data file being moved to the user's personal space.

Responses

207

application/json

The result status of the change space operations on each specified data file.

application/jsonobject
Show application/json properties
- dataarray of objects
  Required
  
  List of individual results for the items in the specified batch.
  
  Show data properties
  
  idstring
  Required
  
  The unique identifier of the file.
  
  format = "uuid"
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.
  
  statusinteger
  Required
  
  The HTTP status code.
  
  format = int32

400

application/json

Bad Request

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

POST /v1/data-files/actions/change-space

curl "https://your-tenant.us.qlikcloud.com/api/v1/data-files/actions/change-space" \
-X POST \
-H "Content-type: application/json" \
-H "Authorization: Bearer <access_token>" \
-d '{"change-space":[{"id":"ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc","spaceId":"617979737a9f56e49dea2e6e"}]}'

const https = require('https')
  const data = JSON.stringify({"change-space":[{"id":"ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc","spaceId":"617979737a9f56e49dea2e6e"}]})
  const options =   {
    'hostname': 'https://your-tenant.us.qlikcloud.com',
    'port': 443,
    'path': '/api/v1/data-files/actions/change-space',
    'method': 'POST',
    'headers': {
      'Content-type': 'application/json',
      'Authorization': 'Bearer <access_token>'
    }
  }
  const req = https.request(options)
  req.write(data)

This API is not included yet in qlik-cli

Request

{
  "change-space": [
    {
      "id": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc",
      "spaceId": "617979737a9f56e49dea2e6e"
    }
  ]
}

Response

{
  "data": [
    {
      "id": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc",
      "code": "HTTP-200",
      "title": "Cursor not formatted correctly.",
      "detail": "Invalid encoding of cursor.",
      "status": 400
    }
  ]
}

Facts

Rate limit	Tier 2 (100 requests per minute)
Categories	managebuild

Request Body

application/json

The specification of the batch of data files and folders to delete.

application/jsonobject
Show application/json properties
- deletearray of objects
  Required
  
  If specified, the explicit list of data files to delete.
  
  Show delete properties
  
  idstring
  Required
  
  The ID of the data file to delete.
  
  format = "uuid"
- deleteAllBySpacearray of objects
  
  If specified, attempt to delete all of the data files from the specified shared spaces.
  
  Show deleteAllBySpace properties
  
  idstring
  Required
  
  The ID of the space whose data files will be deleted.
  
  minLength = 1
- deleteAllFromPersonalSpaceboolean
  
  If specified, attempt to delete all of the datafiles from ther user's personal space.

Responses

207

application/json

The result status of the delete operations on each specified data file or folder.

application/jsonobject
Show application/json properties
- dataarray of objects
  Required
  
  List of individual results for the items in the specified batch.
  
  Show data properties
  
  idstring
  Required
  
  The unique identifier of the file.
  
  format = "uuid"
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.
  
  statusinteger
  Required
  
  The HTTP status code.
  
  format = int32

400

application/json

Bad Request

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

POST /v1/data-files/actions/delete

curl "https://your-tenant.us.qlikcloud.com/api/v1/data-files/actions/delete" \
-X POST \
-H "Content-type: application/json" \
-H "Authorization: Bearer <access_token>" \
-d '{"delete":[{"id":"ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc"}],"deleteAllBySpace":[{"id":"617979737a9f56e49dea2e6e"}],"deleteAllFromPersonalSpace":true}'

const https = require('https')
  const data = JSON.stringify({"delete":[{"id":"ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc"}],"deleteAllBySpace":[{"id":"617979737a9f56e49dea2e6e"}],"deleteAllFromPersonalSpace":true})
  const options =   {
    'hostname': 'https://your-tenant.us.qlikcloud.com',
    'port': 443,
    'path': '/api/v1/data-files/actions/delete',
    'method': 'POST',
    'headers': {
      'Content-type': 'application/json',
      'Authorization': 'Bearer <access_token>'
    }
  }
  const req = https.request(options)
  req.write(data)

qlik data-file delete \
--delete='{"id":"ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc"}'

Request

{
  "delete": [
    {
      "id": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc"
    }
  ],
  "deleteAllBySpace": [
    {
      "id": "617979737a9f56e49dea2e6e"
    }
  ],
  "deleteAllFromPersonalSpace": true
}

Response

{
  "data": [
    {
      "id": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc",
      "code": "HTTP-200",
      "title": "Cursor not formatted correctly.",
      "detail": "Invalid encoding of cursor.",
      "status": 400
    }
  ]
}

The non-filtered list contains a set of hardcoded connections, along with one connection per team space that the given user has access to.

Facts

Rate limit	Tier 1 (1000 requests per minute)
Categories	managebuild

Query Parameters

appIdstring

If present, get connections with connection strings that are scoped to the given app ID.
includeSpaceStatsboolean

If set to true, include computed space-level statistics for the spaces represented by the connections in the returned list. If false, this information is not returned.

default = false
limitinteger

If present, the maximum number of data file connection records to return.

minimum = 1, maximum = 1000, default = 20, format = int32, default = 20
namestring

If present, only return connections with the given name.
pagestring

If present, the cursor that starts the page of data that is returned.
personalboolean

If true, only return the connections that access data in a personal space. Default is false.

default = false
sortstring

The name of the field used to sort the result. By default, the sort is ascending. Putting a '+' prefix on the sort field name explicitly indicates ascending sort order. A '-' prefix indicates a descending sort order.

Can be one of: "spaceId""+spaceId""-spaceId"
spaceIdstring

If present, only return the connection that accesses data files in the specified space.

Responses

200

application/json

Connection list was returned.

application/jsonobject
Show application/json properties
- dataarray of objects
  Required
  
  Properties of the connections to the tenant spaces.
  
  Show data properties
  
  idstring
  Required
  
  The unique identifier of the connection.
  
  format = "uuid"
  
  namestring
  Required
  
  The name of the connection.
  
  typestring
  Required
  
  The type of the connection.
  
  spaceIdstring
  
  The team space that the given connection is associated with. If null, the connection is not associated with any specific team space.
  
  spaceStatsobject
  
  Show spaceStats properties
  
  totalFileCountinteger
  Required
  
  The number of data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directFileCountinteger
  Required
  
  The number of data files that reside as direct children of the given folder.
  
  format = int64
  
  totalFolderCountinteger
  Required
  
  The number of folders that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  aggregateFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directFolderCountinteger
  Required
  
  The number of sub-folders that reside as direct children of the given folder.
  
  format = int64
  
  totalInternalFileCountinteger
  Required
  
  The number of 'internal' data files (IE, those that are not visible to end users by default) that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directInternalFileCountinteger
  Required
  
  The number of 'internal' data files (IE, those that are not visible to end users by default) that reside as direct children of the given folder.
  
  format = int64
  
  totalAppScopedFileCountinteger
  Required
  
  The number of app-scoped data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directAppScopedFileCountinteger
  Required
  
  The number of app-scoped data files that reside as direct children of the given folder.
  
  format = int64
  
  aggregateInternalFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all internal data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  aggregateAppScopedFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all app-scoped data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  connectStatementstring
  Required
  
  The connect statement that will be passed to the connector when invoked.
- linksobject
  Required
  
  Show links properties
  
  nextobject
  Required
  
  Show next properties
  
  hrefstring
  
  The URL for the link.
  
  format = "uri"
  
  prevobject
  Required
  
  Show prev properties
  
  hrefstring
  
  The URL for the link.
  
  format = "uri"
  
  selfobject
  Required
  
  Show self properties
  
  hrefstring
  
  The URL for the link.
  
  format = "uri"

400

application/json

Bad Request

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

403

application/json

Forbidden

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

GET /v1/data-files/connections

curl "https://your-tenant.us.qlikcloud.com/api/v1/data-files/connections" \
-H "Authorization: Bearer <access_token>"

const https = require('https')
  const data = JSON.stringify("")
  const options =   {
    'hostname': 'https://your-tenant.us.qlikcloud.com',
    'port': 443,
    'path': '/api/v1/data-files/connections',
    'method': 'GET',
    'headers': {
      'Authorization': 'Bearer <access_token>'
    }
  }
  const req = https.request(options)

qlik data-file connection ls

Response

{
  "data": [
    {
      "id": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc",
      "name": "DataFiles",
      "type": "qix-datafiles.exe",
      "spaceId": "617979737a9f56e49dea2e6e",
      "spaceStats": {
        "totalFileCount": 50,
        "directFileCount": 50,
        "totalFolderCount": 50,
        "aggregateFileSize": 10000,
        "directFolderCount": 50,
        "totalInternalFileCount": 50,
        "directInternalFileCount": 50,
        "totalAppScopedFileCount": 50,
        "directAppScopedFileCount": 50,
        "aggregateInternalFileSize": 10000,
        "aggregateAppScopedFileSize": 10000
      },
      "connectStatement": "CUSTOM CONNECT TO \\\"provider=qix-datafiles.exe;path=mydatafiles;\\\""
    }
  ],
  "links": {
    "next": {
      "href": "string"
    },
    "prev": {
      "href": "string"
    },
    "self": {
      "href": "string"
    }
  }
}

Facts

Rate limit	Tier 1 (1000 requests per minute)
Categories	managebuild

Path Parameters

idstring
Required

The ID of the connection.

format = "uuid"

Responses

200

application/json

The connection was returned.

application/jsonobject
Show application/json properties
- idstring
  Required
  
  The unique identifier of the connection.
  
  format = "uuid"
- namestring
  Required
  
  The name of the connection.
- typestring
  Required
  
  The type of the connection.
- spaceIdstring
  
  The team space that the given connection is associated with. If null, the connection is not associated with any specific team space.
- spaceStatsobject
  
  Show spaceStats properties
  
  totalFileCountinteger
  Required
  
  The number of data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directFileCountinteger
  Required
  
  The number of data files that reside as direct children of the given folder.
  
  format = int64
  
  totalFolderCountinteger
  Required
  
  The number of folders that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  aggregateFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directFolderCountinteger
  Required
  
  The number of sub-folders that reside as direct children of the given folder.
  
  format = int64
  
  totalInternalFileCountinteger
  Required
  
  The number of 'internal' data files (IE, those that are not visible to end users by default) that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directInternalFileCountinteger
  Required
  
  The number of 'internal' data files (IE, those that are not visible to end users by default) that reside as direct children of the given folder.
  
  format = int64
  
  totalAppScopedFileCountinteger
  Required
  
  The number of app-scoped data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  directAppScopedFileCountinteger
  Required
  
  The number of app-scoped data files that reside as direct children of the given folder.
  
  format = int64
  
  aggregateInternalFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all internal data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
  
  aggregateAppScopedFileSizeinteger
  Required
  
  The sum of the file sizes, in bytes, of all app-scoped data files that reside as direct and indirect children of the given folder and it's sub-folder hierarchy.
  
  format = int64
- connectStatementstring
  Required
  
  The connect statement that will be passed to the connector when invoked.

403

application/json

The space referenced by the specified connection was not found, or is not accessible to the current user.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

404

application/json

A connection with the specified ID was not found.

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

GET /v1/data-files/connections/{id}

curl "https://your-tenant.us.qlikcloud.com/api/v1/data-files/connections/{id}" \
-H "Authorization: Bearer <access_token>"

const https = require('https')
  const data = JSON.stringify("")
  const options =   {
    'hostname': 'https://your-tenant.us.qlikcloud.com',
    'port': 443,
    'path': '/api/v1/data-files/connections/{id}',
    'method': 'GET',
    'headers': {
      'Authorization': 'Bearer <access_token>'
    }
  }
  const req = https.request(options)

qlik data-file connection get <connectionId>

Response

{
  "id": "ee6a390c-5d33-11e8-9c2d-fa7ae01bbebc",
  "name": "DataFiles",
  "type": "qix-datafiles.exe",
  "spaceId": "617979737a9f56e49dea2e6e",
  "spaceStats": {
    "totalFileCount": 50,
    "directFileCount": 50,
    "totalFolderCount": 50,
    "aggregateFileSize": 10000,
    "directFolderCount": 50,
    "totalInternalFileCount": 50,
    "directInternalFileCount": 50,
    "totalAppScopedFileCount": 50,
    "directAppScopedFileCount": 50,
    "aggregateInternalFileSize": 10000,
    "aggregateAppScopedFileSize": 10000
  },
  "connectStatement": "CUSTOM CONNECT TO \\\"provider=qix-datafiles.exe;path=mydatafiles;\\\""
}

Facts

Rate limit	Tier 1 (1000 requests per minute)
Categories	managebuild

Responses

200

application/json

The quota information was retrieved.

application/jsonobject
Show application/json properties
- sizeinteger
  Required
  
  The current aggregate size of all files uploaded by a given user. If the current aggregate size is greater than the maximum aggregate size, this is a quota violation.
  
  format = int64
- maxSizeinteger
  Required
  
  The maximum aggregate size of all files uploaded by a given user.
  
  format = int64
- maxFileSizeinteger
  Required
  
  Maximum allowable size of an uploaded file.
  
  format = int64
- maxLargeFileSizeinteger
  Required
  
  Maximum allowable size for a single uploaded large data file (in bytes). This is a file that was indirectly uploaded using the temp content service chunked upload capability.
  
  format = int64
- allowedExtensionsarray of strings
  Required
  
  The allowed file extensions on files that are uploaded.
- allowedInternalExtensionsarray of strings
  Required
  
  The allowed file extensions for files that are only used internally by the system (and thus not typically shown to end users).

400

application/json

Bad Request

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

403

application/json

Forbidden

application/jsonobject
Show application/json properties
- errorsarray of objects
  Required
  
  List of errors and their properties.
  
  Show errors properties
  
  codestring
  Required
  
  Fine-grained error codes for data-files REST operations. For operations which do not have a more fine-grained error code, the error code is set to the HTTP status code.
  Members:
  DF-001 - The page cursor passed as a parameter to the GET operation is invalid.
  DF-002 - The sort specification passed as a parameter to the GET operation is invalid.
  DF-003 - FolderPath and FolderId are mutually exclusive, they cannot both be passed as parameters.
  DF-004 - The provided FolderPath must be in canonical form.
  DF-005 - The specified parent folder cannot be found.
  DF-006 - The specified owner cannot be found.
  DF-007 - A connection corresponding to the specified space cannot be found.
  DF-008 - THe specified ID must correspond to a folder, not a file.
  DF-009 - The specified space cannot be found.
  DF-010 - The specified file name contains an invalid file extension.
  DF-011 - The specified file name is missing a file extension.
  DF-012 - The specified temporary content file could not be found.
  DF-013 - Access to the specified space is forbidden.
  DF-014 - The specified connection cannot be found.
  DF-015 - The provided filename must be in canonical form.
  DF-016 - The datafile size quota for the given personal space has been exceeded.
  DF-017 - The specified source file or folder could not be found.
  DF-018 - The source and target of a datafile operation must either both be folders or both be files, but they are not.
  DF-019 - The specified target folder is a child of the specified source folder, which is not allowed.
  DF-020 - The specified folder does not exist in the specified space.
  DF-021 - The specified source file or folder is already locked.
  DF-022 - The automatic creation of a missing parent folder failed.
  DF-023 - An attempt to lock a parent folder of a given data file item failed.
  DF-024 - The attempt to copy a source file or folder to a target failed.
  DF-025 - The specified target file or folder is already locked.
  DF-026 - The request results in the creation of a folder hierarchy which is beyond the max allowed folder hierarchy depth.
  
  Can be one of: "HTTP-200""HTTP-201""HTTP-204""HTTP-400""HTTP-403""HTTP-404""HTTP-409""HTTP-413""HTTP-423""HTTP-500""HTTP-501""HTTP-503""DF-001""DF-002""DF-003""DF-004""DF-005""DF-006""DF-007""DF-008""DF-009""DF-010""DF-011""DF-012""DF-013""DF-014""DF-015""DF-016""DF-017""DF-018""DF-019""DF-020""DF-021""DF-022""DF-023""DF-024""DF-025""DF-026"
  
  titlestring
  
  Summary of the problem.
  
  detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

GET /v1/data-files/quotas

curl "https://your-tenant.us.qlikcloud.com/api/v1/data-files/quotas" \
-H "Authorization: Bearer <access_token>"

const https = require('https')
  const data = JSON.stringify("")
  const options =   {
    'hostname': 'https://your-tenant.us.qlikcloud.com',
    'port': 443,
    'path': '/api/v1/data-files/quotas',
    'method': 'GET',
    'headers': {
      'Authorization': 'Bearer <access_token>'
    }
  }
  const req = https.request(options)

qlik data-file quotas

Response

{
  "size": 5000,
  "maxSize": 9223372036854776000,
  "maxFileSize": 524288000,
  "maxLargeFileSize": 6442450944,
  "allowedExtensions": [
    "string"
  ],
  "allowedInternalExtensions": [
    "string"
  ]
}

Data files

Endpoints

Get descriptive info for the specified data files.

Facts

Query Parameters

Responses

200

400

403

Response

Upload a new data file or create a new folder.

Facts

Request Body

Responses

201

400

403

409

413

423

501

Request

Response

Get descriptive info for the specified data file.

Facts

Path Parameters

Responses

200

400

403

404

Response

Re-upload an existing data file or update an existing folder.

Facts

Path Parameters

Request Body

Responses

201

400

403

404

409

413

423

Request

Response

Delete the specified data file or folder. Deleting a folder will also recursively delete all files and subfolders that reside within the specified folder.

Facts

Path Parameters

Responses

204

400

403

404

Change the owner of an existing data file or folder.

Facts

Path Parameters

Request Body

Responses

204

400

403

404

409

423

Request

Change the space that an existing data file or folder resides in.

Facts

Path Parameters

Request Body

Responses

204

400

403

404

409

423

Request

Change the spaces that a set of existing data files or folders reside in a a single batch.

Facts