data-assets

Save new data asset.

Request Body POST /data-assets

Data Asset

application/json

No description

Responses POST /data-assets

201 application/json DataAsset	Created new data asset successfully.
400 application/json ErrorResponse	The request is in incorrect format.
401 application/json ErrorResponse	User does not have valid authentication credentials.
403 application/json ErrorResponse	User does not have access to the resource.
404 application/json ErrorResponse	Resource does not exist.
409 application/json ErrorResponse	The input request conflicts with the current state of the resource.
500 application/json ErrorResponse	Internal Server Error.
503 application/json ErrorResponse	Requested service is not available.

POST/data-assets

curl "https://your-tenant.us.qlikcloud.com/api/v1/data-assets" \
 -X POST \
 -H "Authorization: Bearer <API-key>" \
 -H "Content-type: application/json" \
 -d '{"id":"string","name":"string","description":"string","tenantId":"string","spaceId":"string","ownerId":"string","createdTime":"2022-06-28T20:33:35.586Z","createdBy":"string","lastModifiedTime":"2022-06-28T20:33:35.586Z","lastModifiedBy":"string","version":0,"technicalDescription":"string","technicalName":"string","tags":[],"properties":{},"appType":"string","appId":"string","dataStoreInfo":{"id":"string","name":"string","type":"string"}}'

Request POST /data-assets

{
  "id": "string",
  "name": "string",
  "description": "string",
  "tenantId": "string",
  "spaceId": "string",
  "ownerId": "string",
  "createdTime": "2022-06-28T20:33:35.586Z",
  "createdBy": "string",
  "lastModifiedTime": "2022-06-28T20:33:35.586Z",
  "lastModifiedBy": "string",
  "version": 0,
  "technicalDescription": "string",
  "technicalName": "string",
  "tags": [],
  "properties": {},
  "appType": "string",
  "appId": "string",
  "dataStoreInfo": {
    "id": "string",
    "name": "string",
    "type": "string"
  }
}

Response POST /data-assets

{
  "id": "string",
  "name": "string",
  "description": "string",
  "tenantId": "string",
  "spaceId": "string",
  "ownerId": "string",
  "createdTime": "2022-06-28T20:33:35.586Z",
  "createdBy": "string",
  "lastModifiedTime": "2022-06-28T20:33:35.586Z",
  "lastModifiedBy": "string",
  "version": 0,
  "technicalDescription": "string",
  "technicalName": "string",
  "tags": [],
  "properties": {},
  "appType": "string",
  "appId": "string",
  "dataStoreInfo": {
    "id": "string",
    "name": "string",
    "type": "string"
  }
}

Batch delete data assets by IDs.

Request Body DELETE /data-assets/

application/json

BatchIdDto

No description

Responses DELETE /data-assets/

204 object	Deleted data asset with all child objects.
400 application/json ErrorResponse	The request is in incorrect format.
401 application/json ErrorResponse	User does not have valid authentication credentials.
403 application/json ErrorResponse	User does not have access to the resource.
404 application/json ErrorResponse	Resource does not exist.
409 application/json ErrorResponse	The input request conflicts with the current state of the resource.
500 application/json ErrorResponse	Internal Server Error.
503 application/json ErrorResponse	Requested service is not available.

DELETE/data-assets/

curl "https://your-tenant.us.qlikcloud.com/api/v1/data-assets/" \
 -X DELETE \
 -H "Authorization: Bearer <API-key>" \
 -H "Content-type: application/json" \
 -d '{"ids":[]}'

Request DELETE /data-assets/

{
  "ids": []
}

Get data asset by ID.

Path Parameters GET /data-assets/{data-asset-id}

data-asset-id

string

No description

Query Parameters GET /data-assets/{data-asset-id}

projections

optional

Array<string>

Comma-separated fields to return in the response.

Responses GET /data-assets/{data-asset-id}

200 application/json DataAsset	Successful Operation.
400 application/json ErrorResponse	The request is in incorrect format.
401 application/json ErrorResponse	User does not have valid authentication credentials.
403 application/json ErrorResponse	User does not have access to the resource.
404 application/json ErrorResponse	Resource does not exist.
409 application/json ErrorResponse	The input request conflicts with the current state of the resource.
500 application/json ErrorResponse	Internal Server Error.
503 application/json ErrorResponse	Requested service is not available.

GET/data-assets/{data-asset-id}

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

Response GET /data-assets/{data-asset-id}

{
  "id": "string",
  "name": "string",
  "description": "string",
  "tenantId": "string",
  "spaceId": "string",
  "ownerId": "string",
  "createdTime": "2022-06-28T20:33:35.586Z",
  "createdBy": "string",
  "lastModifiedTime": "2022-06-28T20:33:35.586Z",
  "lastModifiedBy": "string",
  "version": 0,
  "technicalDescription": "string",
  "technicalName": "string",
  "tags": [],
  "properties": {},
  "appType": "string",
  "appId": "string",
  "dataStoreInfo": {
    "id": "string",
    "name": "string",
    "type": "string"
  }
}

Update data asset.

Path Parameters PUT /data-assets/{data-asset-id}

data-asset-id

string

No description

Request Body PUT /data-assets/{data-asset-id}

Data Asset

application/json

DataAsset

No description

Responses PUT /data-assets/{data-asset-id}

200 application/json DataAsset	Updated data asset successfully.
400 application/json ErrorResponse	The request is in incorrect format.
401 application/json ErrorResponse	User does not have valid authentication credentials.
403 application/json ErrorResponse	User does not have access to the resource.
404 application/json ErrorResponse	Resource does not exist.
409 application/json ErrorResponse	The input request conflicts with the current state of the resource.
500 application/json ErrorResponse	Internal Server Error.
503 application/json ErrorResponse	Requested service is not available.

PUT/data-assets/{data-asset-id}

curl "https://your-tenant.us.qlikcloud.com/api/v1/data-assets/{data-asset-id}" \
 -X PUT \
 -H "Authorization: Bearer <API-key>" \
 -H "Content-type: application/json" \
 -d '{"id":"string","name":"string","description":"string","tenantId":"string","spaceId":"string","ownerId":"string","createdTime":"2022-06-28T20:33:35.587Z","createdBy":"string","lastModifiedTime":"2022-06-28T20:33:35.587Z","lastModifiedBy":"string","version":0,"technicalDescription":"string","technicalName":"string","tags":[],"properties":{},"appType":"string","appId":"string","dataStoreInfo":{"id":"string","name":"string","type":"string"}}'

Request PUT /data-assets/{data-asset-id}

{
  "id": "string",
  "name": "string",
  "description": "string",
  "tenantId": "string",
  "spaceId": "string",
  "ownerId": "string",
  "createdTime": "2022-06-28T20:33:35.587Z",
  "createdBy": "string",
  "lastModifiedTime": "2022-06-28T20:33:35.587Z",
  "lastModifiedBy": "string",
  "version": 0,
  "technicalDescription": "string",
  "technicalName": "string",
  "tags": [],
  "properties": {},
  "appType": "string",
  "appId": "string",
  "dataStoreInfo": {
    "id": "string",
    "name": "string",
    "type": "string"
  }
}

Response PUT /data-assets/{data-asset-id}

{
  "id": "string",
  "name": "string",
  "description": "string",
  "tenantId": "string",
  "spaceId": "string",
  "ownerId": "string",
  "createdTime": "2022-06-28T20:33:35.587Z",
  "createdBy": "string",
  "lastModifiedTime": "2022-06-28T20:33:35.587Z",
  "lastModifiedBy": "string",
  "version": 0,
  "technicalDescription": "string",
  "technicalName": "string",
  "tags": [],
  "properties": {},
  "appType": "string",
  "appId": "string",
  "dataStoreInfo": {
    "id": "string",
    "name": "string",
    "type": "string"
  }
}

Patch data asset.

Path Parameters PATCH /data-assets/{data-asset-id}

data-asset-id

string

No description

Request Body PATCH /data-assets/{data-asset-id}

application/json

Array<JsonPatch>

No description

Responses PATCH /data-assets/{data-asset-id}

200 application/json DataAsset	Patched data asset successfully.
204 application/json DataAsset	Patched data asset successfully.
400 application/json ErrorResponse	The request is in incorrect format.
401 application/json ErrorResponse	User does not have valid authentication credentials.
403 application/json ErrorResponse	User does not have access to the resource.
404 application/json ErrorResponse	Resource does not exist.
409 application/json ErrorResponse	The input request conflicts with the current state of the resource.
500 application/json ErrorResponse	Internal Server Error.
503 application/json ErrorResponse	Requested service is not available.

PATCH/data-assets/{data-asset-id}

curl "https://your-tenant.us.qlikcloud.com/api/v1/data-assets/{data-asset-id}" \
 -X PATCH \
 -H "Authorization: Bearer <API-key>" \
 -H "Content-type: application/json" \
 -d '{"op":"add","path":"string","value":{},"from":"string"}'

Request PATCH /data-assets/{data-asset-id}

{
  "op": "add",
  "path": "string",
  "value": {},
  "from": "string"
}

Response PATCH /data-assets/{data-asset-id}

{
  "id": "string",
  "name": "string",
  "description": "string",
  "tenantId": "string",
  "spaceId": "string",
  "ownerId": "string",
  "createdTime": "2022-06-28T20:33:35.587Z",
  "createdBy": "string",
  "lastModifiedTime": "2022-06-28T20:33:35.587Z",
  "lastModifiedBy": "string",
  "version": 0,
  "technicalDescription": "string",
  "technicalName": "string",
  "tags": [],
  "properties": {},
  "appType": "string",
  "appId": "string",
  "dataStoreInfo": {
    "id": "string",
    "name": "string",
    "type": "string"
  }
}

BatchIdDto

object

Properties

ids

Array<string>

No description

Classifications

object

Classifications

Properties

subjectArea string	No description
personalInformation Array<string>	No description
sensitiveInformation Array<string>	No description

DataAsset

object

Data Asset

Properties

id optional string	Only required when updating the resource. Must be null for new resources.
name optional string	No description
description optional string	No description
tenantId optional string	The value is automatically set by the application. User defined value is ignored.
spaceId optional string	No description
ownerId optional string	The value is automatically set by the application.
createdTime optional string<date-time>	The value is automatically set by the application. User defined value is ignored.
createdBy optional string	The value is automatically set by the application. User defined value is ignored.
lastModifiedTime optional string<date-time>	The value is automatically set by the application. User defined value is ignored.
lastModifiedBy optional string	The value is automatically set by the application. User defined value is ignored.
version optional integer<int64>	Only required when updating the resource. Must be null for new resources.
technicalDescription optional string	No description
technicalName string	No description
tags optional Array<string>	No description
properties optional object	A Map of name-value pairs.
appType string	No description
appId string	No description
dataStoreInfo optional DataStoreInfo	No description

DataAssetDeletion

object

Properties

id optional string	No description
name string	No description
createdTime optional string<date-time>	No description
createdBy optional string	No description
lastModifiedTime optional string<date-time>	No description
lastModifiedBy optional string	No description
version optional integer<int64>	No description
description optional string	No description
tenantId optional string	No description
spaceId optional string	No description
ownerId optional string	No description
technicalDescription optional string	No description
technicalName optional string	No description
systemProperties optional SystemProperties	No description
tags optional Array<string>	No description
properties optional object	No description
dataAssetId optional string	No description
deletedTime optional string<date-time>	No description
resourceType optional string	No description

DataAssetInfo

object

Properties

id string	No description
name optional string	No description
dataStoreInfo optional DataStoreInfo	No description

DataConnectionInfo

object

Data Connection Info

Properties

connectionId string	No description
spaceId string	No description
database string	No description
schema string	No description
tables Array<TableConnectionInfo>	No description

DataField

object

Properties

name string	No description
alias optional string	No description
description optional string	No description
ordinalPositionInKey optional integer<int32>	No description
index optional integer<int32>	No description
dataType optional FieldDataType	No description
tags optional Array<string>	No description
properties optional object	No description
encrypted optional boolean	No description
primaryKey optional boolean	No description
sensitive optional boolean	No description
orphan optional boolean	No description
nullable optional boolean	No description

DataSet

object

Data Set

Properties

id optional string	Only required when updating the resource. Must be null for new resources.
name optional string	No description
description optional string	No description
tenantId optional string	The value is automatically set by the application. User defined value is ignored.
spaceId optional string	No description
ownerId optional string	The value is automatically set by the application.
createdTime optional string<date-time>	The value is automatically set by the application. User defined value is ignored.
createdBy optional string	The value is automatically set by the application. User defined value is ignored.
lastModifiedTime optional string<date-time>	The value is automatically set by the application. User defined value is ignored.
lastModifiedBy optional string	The value is automatically set by the application. User defined value is ignored.
version optional integer<int64>	Only required when updating the resource. Must be null for new resources.
technicalDescription optional string	No description
technicalName string	No description
tags optional Array<string>	No description
properties optional object	A Map of name-value pairs.
dataAssetInfo optional DataAssetInfo	No description
Operational optional Operational	Operational
Schema optional Schema	Optional field to specify additional schemas for files where multiple tables or sheets are available. User must define primary schema in 'schema' attribute and rest of the sheets/ tables can be defined using this field. This field is not populated for the dataSets with single schema
additionalSchemas optional Array<Schema>	Optional field to specify additional schemas for files where multiple tables or sheets are available. User must define primary schema in 'schema' attribute and rest of the sheets/ tables can be defined using this field. This field is not populated for the dataSets with single schema
qri string<qdf:<store-type>:<tenant-guid>:<<uid@/sid@>user/space guid>:<path-to-file>>	NOTE: this will be deprecated after migration to secureQri. Required user defined field. All the parts in the format must be separated by ':'. The first part denotes the resourceType, followed by dataStoreType and tenant guid. The spaceGuid or userGuid is to be populated based on if the dataset is in shared or private space and finally the full file name. This field is auto populated for the dataSet generated for qix-datafiles.
secureQri optional string	No description
type optional string	No description
Classifications optional Classifications	Classifications

DataSetDeletion

object

Properties

id optional string	No description
name string	No description
createdTime optional string<date-time>	No description
createdBy optional string	No description
lastModifiedTime optional string<date-time>	No description
lastModifiedBy optional string	No description
version optional integer<int64>	No description
description optional string	No description
tenantId optional string	No description
spaceId optional string	No description
ownerId optional string	No description
technicalDescription optional string	No description
technicalName optional string	No description
systemProperties optional SystemProperties	No description
tags optional Array<string>	No description
properties optional object	No description
dataSetId optional string	No description
deletedTime optional string<date-time>	No description
resourceType optional string	No description

DataSetInfo

object

Properties

id string	No description
version optional integer<int64>	No description

DataSetRevision

object

Data Set Revision

Properties

id optional string	Only required when updating the resource. Must be null for new resources.
name optional string	No description
description optional string	No description
tenantId optional string	The value is automatically set by the application. User defined value is ignored.
spaceId optional string	No description
ownerId optional string	The value is automatically set by the application.
createdTime optional string<date-time>	The value is automatically set by the application. User defined value is ignored.
createdBy optional string	The value is automatically set by the application. User defined value is ignored.
lastModifiedTime optional string<date-time>	The value is automatically set by the application. User defined value is ignored.
lastModifiedBy optional string	The value is automatically set by the application. User defined value is ignored.
version optional integer<int64>	Only required when updating the resource. Must be null for new resources.
technicalDescription optional string	No description
technicalName string	No description
tags optional Array<string>	No description
properties optional object	A Map of name-value pairs.
dataSetInfo optional DataSetInfo	No description
Schema optional Schema	Optional field to specify additional schemas for files where multiple tables or sheets are available. User must define primary schema in 'schema' attribute and rest of the sheets/ tables can be defined using this field. This field is not populated for the dataSets with single schema
changes optional Array<JsonPatch>	No description
additionalSchemas optional Array<Schema>	No description

DataStore

object

Data Store

Properties

id optional string	Only required when updating the resource. Must be null for new resources.
name optional string	No description
description optional string	No description
tenantId optional string	The value is automatically set by the application. User defined value is ignored.
spaceId optional string	No description
ownerId optional string	The value is automatically set by the application.
createdTime optional string<date-time>	The value is automatically set by the application. User defined value is ignored.
createdBy optional string	The value is automatically set by the application. User defined value is ignored.
lastModifiedTime optional string<date-time>	The value is automatically set by the application. User defined value is ignored.
lastModifiedBy optional string	The value is automatically set by the application. User defined value is ignored.
version optional integer<int64>	Only required when updating the resource. Must be null for new resources.
technicalDescription optional string	No description
technicalName string	No description
tags optional Array<string>	No description
properties optional object	A Map of name-value pairs.
type string	No description
uri string	No description

DataStoreInfo

object

Properties

id string	No description
name optional string	No description
type optional string	No description

Error

object

Properties

status string	No description
code string	No description
title string	No description
detail string	No description

ErrorResponse

object

Properties

errors Array<Error>	No description
traceId string	No description

FieldDataType

object

Properties

type string	Each datatype may vary in terms of required properties. Example: Datatype DECIMAL requires two mandatory properties to be defined - precision and scale, each one accepts integer value. All other datatypes does not have any required properties. Enum: DATE TIME DATETIME TIMESTAMP STRING DOUBLE DECIMAL INTEGER BOOLEAN BINARY CUSTOM
originalType optional string	No description
properties optional object	The properties map key is string and the value is of type object. Please note, Datatype DECIMAL requires two mandatory properties to be defined; these properties must be named: precision and scale, each of these property accepts integer value. All other datatypes does not require any manadatory properties to be defined.

JsonPatch

object

Properties

op string	The operation to be performed. Enum: add remove replace move copy test
path string	A JSON pointer to the property being affected.
value optional object	The value to add, replace or test.
from optional string	A JSON Pointer path pointing to the location to move/copy from.

Link

object

Properties

href

string

No description

Links

object

Properties

self optional Link	No description
first optional Link	No description
last optional Link	No description
next optional Link	No description
prev optional Link	No description

MetadataDomain

object

Properties

name string	No description
description string	No description
properties object	The properties map key is string and the value is another map. The purpose is to allow flexibility in defining any key value pair any level deep.

Operational

object

Operational

Properties

size integer<int64>	No description
rowCount integer<int64>	No description
lastLoadTime string<date-time>	No description
startDate string<date-time>	No description
endDate string<date-time>	No description
logMessage string	No description
status string	No description
location string	No description
contentUpdated boolean	No description
tableOwner string	No description
tableConnectionInfo optional TableConnectionInfo	No description
lastUpdateTime string<date-time>	No description

PageDataAsset

object

Properties

data Array<DataAsset>	No description
page integer<int32>	No description
limit integer<int32>	No description
total integer<int64>	No description
pages integer<int32>	No description
links optional Links	No description

PageDataSet

object

Properties

data Array<DataSet>	No description
page integer<int32>	No description
limit integer<int32>	No description
total integer<int64>	No description
pages integer<int32>	No description
links optional Links	No description

PageDataSetRevision

object

Properties

data Array<DataSetRevision>	No description
page integer<int32>	No description
limit integer<int32>	No description
total integer<int64>	No description
pages integer<int32>	No description
links optional Links	No description

PageDataStore

object

Properties

data Array<DataStore>	No description
page integer<int32>	No description
limit integer<int32>	No description
total integer<int64>	No description
pages integer<int32>	No description
links optional Links	No description

Schema

object

Optional field to specify additional schemas for files where multiple tables or sheets are available. User must define primary schema in 'schema' attribute and rest of the sheets/ tables can be defined using this field. This field is not populated for the dataSets with single schema

Properties

dataFields Array<DataField>	No description
effectiveDate optional string<date-time>	No description
schemaName optional string	No description

SystemProperties

object

Properties

sourceSystemId

string

No description

TableConnectionInfo

object

Properties

tableName string	No description
selectionScript string	No description
additionalProperties object	No description

v3.4.0

data-assets

Endpoints

Save new data asset.

Request Body POST /data-assets

Responses POST /data-assets

POST/data-assets

Request POST /data-assets

Response POST /data-assets

Batch delete data assets by IDs.

Request Body DELETE /data-assets/

Responses DELETE /data-assets/

DELETE/data-assets/

Request DELETE /data-assets/

Get data asset by ID.

Path Parameters GET /data-assets/{data-asset-id}

Query Parameters GET /data-assets/{data-asset-id}

Responses GET /data-assets/{data-asset-id}

GET/data-assets/{data-asset-id}

Response GET /data-assets/{data-asset-id}

Update data asset.

Path Parameters PUT /data-assets/{data-asset-id}

Request Body PUT /data-assets/{data-asset-id}

Responses PUT /data-assets/{data-asset-id}

PUT/data-assets/{data-asset-id}

Request PUT /data-assets/{data-asset-id}

Response PUT /data-assets/{data-asset-id}

Patch data asset.

Path Parameters PATCH /data-assets/{data-asset-id}

Request Body PATCH /data-assets/{data-asset-id}

Responses PATCH /data-assets/{data-asset-id}

PATCH/data-assets/{data-asset-id}

Request PATCH /data-assets/{data-asset-id}

Response PATCH /data-assets/{data-asset-id}

BatchIdDto

Properties

Classifications

Properties

DataAsset

Properties

DataAssetDeletion

Properties

DataAssetInfo

Properties

DataConnectionInfo

Properties

DataField

Properties

DataSet

Properties

DataSetDeletion

Properties

DataSetInfo

Properties

DataSetRevision

Properties

DataStore

Properties

DataStoreInfo

Properties

Error

Properties

ErrorResponse

Properties

FieldDataType

Properties

JsonPatch

Properties

Link

Properties

Links

Properties

MetadataDomain

Properties

Operational

Properties

PageDataAsset

Properties

PageDataSet

Properties

PageDataSetRevision