Data stores
Data stores are part of the catalog in Qlik Cloud. A data store may contain one or more data stores, which in turn may contain multiple data sets.
Endpoints
- GET/v1/data-stores
- POST/v1/data-stores
- DELETE/v1/data-stores
- GET/v1/data-stores/{data-store-id}
- PATCH/v1/data-stores/{data-store-id}
- PUT/v1/data-stores/{data-store-id}
- GET/v1/data-stores/{data-store-ids}/data-assets
- DELETE/v1/data-stores/{data-store-ids}/data-assets
- GET/v1/data-stores/{data-store-ids}/data-assets/{data-asset-ids}/data-sets
- DELETE/v1/data-stores/{data-store-ids}/data-assets/{data-asset-ids}/data-sets
Facts
Rate limit | Tier 1 (1000 requests per minute) |
Categories | build |
Query Parameters
- limitinteger
Page size limit.
- pageinteger
- projectionsarray of strings
Comma-separated fields to return in the response.
- sortarray of strings
Comma-separated fields and field start with '-' character sorts the result set in descending order.
Responses
200
application/json
Successful Operation
- application/jsonobject
application/json properties
- dataarray of objects
data properties
- idstring
Only required when updating the resource. Must be null for new resources.
- uristring
- namestring
- tagsarray of strings
- typestringRequired
- ownerIdstring
The value is automatically set by the application.
- spaceIdstring
- versioninteger
Only required when updating the resource. Must be null for new resources.
- tenantIdstring
The value is automatically set by the application. User defined value is ignored.
- createdBystring
The value is automatically set by the application. User defined value is ignored.
- propertiesobject
A Map of name-value pairs.
- createdTimestring
The value is automatically set by the application. User defined value is ignored.
- descriptionstring
- technicalNamestringRequired
- lastModifiedBystring
The value is automatically set by the application. User defined value is ignored.
- lastModifiedTimestring
The value is automatically set by the application. User defined value is ignored.
- technicalDescriptionstring
-
- pageinteger
- limitinteger
- linksobject
links properties
- lastobject
last properties
- hrefstring
-
- nextobject
next properties
- hrefstring
-
- prevobject
prev properties
- hrefstring
-
- selfobject
self properties
- hrefstring
-
- firstobject
first properties
- hrefstring
-
-
- pagesinteger
- totalinteger
-
400
application/json
The request is in incorrect format.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
401
application/json
User does not have valid authentication credentials.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
403
application/json
User does not have access to the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
409
application/json
The input request conflicts with the current state of the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
500
application/json
Internal Server Error.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
503
application/json
Requested service is not available.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/data-stores" \
-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-stores',
'method': 'GET',
'headers': {
'Authorization': 'Bearer <access_token>'
}
}
const req = https.request(options)
This API is not included yet in qlik-cli
Response
{
"data": [
{
"id": "string",
"uri": "string",
"name": "string",
"tags": [
"string"
],
"type": "string",
"ownerId": "string",
"spaceId": "string",
"version": 42,
"tenantId": "string",
"createdBy": "string",
"properties": {},
"createdTime": "2018-10-30T07:06:22Z",
"description": "string",
"technicalName": "string",
"lastModifiedBy": "string",
"lastModifiedTime": "2018-10-30T07:06:22Z",
"technicalDescription": "string"
}
],
"page": 42,
"limit": 42,
"links": {
"last": {
"href": "string"
},
"next": {
"href": "string"
},
"prev": {
"href": "string"
},
"self": {
"href": "string"
},
"first": {
"href": "string"
}
},
"pages": 42,
"total": 42
}
Facts
Rate limit | Tier 2 (100 requests per minute) |
Categories | build |
Request Body
Requiredapplication/json
- application/jsonobject
application/json properties
- idstring
Only required when updating the resource. Must be null for new resources.
- uristring
- namestring
- tagsarray of strings
- typestringRequired
- ownerIdstring
The value is automatically set by the application.
- spaceIdstring
- versioninteger
Only required when updating the resource. Must be null for new resources.
- propertiesobject
A Map of name-value pairs.
- descriptionstring
- technicalNamestringRequired
- technicalDescriptionstring
-
Responses
201
application/json
Created new data store successfully.
- application/jsonobject
application/json properties
- idstring
Only required when updating the resource. Must be null for new resources.
- uristring
- namestring
- tagsarray of strings
- typestringRequired
- ownerIdstring
The value is automatically set by the application.
- spaceIdstring
- versioninteger
Only required when updating the resource. Must be null for new resources.
- tenantIdstring
The value is automatically set by the application. User defined value is ignored.
- createdBystring
The value is automatically set by the application. User defined value is ignored.
- propertiesobject
A Map of name-value pairs.
- createdTimestring
The value is automatically set by the application. User defined value is ignored.
- descriptionstring
- technicalNamestringRequired
- lastModifiedBystring
The value is automatically set by the application. User defined value is ignored.
- lastModifiedTimestring
The value is automatically set by the application. User defined value is ignored.
- technicalDescriptionstring
-
400
application/json
The request is in incorrect format.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
401
application/json
User does not have valid authentication credentials.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
403
application/json
User does not have access to the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
409
application/json
The input request conflicts with the current state of the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
500
application/json
Internal Server Error.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
503
application/json
Requested service is not available.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/data-stores" \
-X POST \
-H "Content-type: application/json" \
-H "Authorization: Bearer <access_token>" \
-d '{"id":"string","uri":"string","name":"string","tags":["string"],"type":"string","ownerId":"string","spaceId":"string","version":42,"properties":{},"description":"string","technicalName":"string","technicalDescription":"string"}'
const https = require('https')
const data = JSON.stringify({"id":"string","uri":"string","name":"string","tags":["string"],"type":"string","ownerId":"string","spaceId":"string","version":42,"properties":{},"description":"string","technicalName":"string","technicalDescription":"string"})
const options = {
'hostname': 'https://your-tenant.us.qlikcloud.com',
'port': 443,
'path': '/api/v1/data-stores',
'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
{
"id": "string",
"uri": "string",
"name": "string",
"tags": [
"string"
],
"type": "string",
"ownerId": "string",
"spaceId": "string",
"version": 42,
"properties": {},
"description": "string",
"technicalName": "string",
"technicalDescription": "string"
}
Response
{
"id": "string",
"uri": "string",
"name": "string",
"tags": [
"string"
],
"type": "string",
"ownerId": "string",
"spaceId": "string",
"version": 42,
"tenantId": "string",
"createdBy": "string",
"properties": {},
"createdTime": "2018-10-30T07:06:22Z",
"description": "string",
"technicalName": "string",
"lastModifiedBy": "string",
"lastModifiedTime": "2018-10-30T07:06:22Z",
"technicalDescription": "string"
}
Facts
Rate limit | Tier 2 (100 requests per minute) |
Categories | build |
Request Body
Requiredapplication/json
- application/jsonobject
application/json properties
- idsarray of strings
-
Responses
204
Deleted empty data stores.
400
application/json
The request is in incorrect format.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
401
application/json
User does not have valid authentication credentials.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
403
application/json
User does not have access to the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
409
application/json
The input request conflicts with the current state of the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
500
application/json
Internal Server Error.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
503
application/json
Requested service is not available.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/data-stores" \
-X DELETE \
-H "Content-type: application/json" \
-H "Authorization: Bearer <access_token>" \
-d '{"ids":["string"]}'
const https = require('https')
const data = JSON.stringify({"ids":["string"]})
const options = {
'hostname': 'https://your-tenant.us.qlikcloud.com',
'port': 443,
'path': '/api/v1/data-stores',
'method': 'DELETE',
'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
{
"ids": [
"string"
]
}
Facts
Rate limit | Tier 1 (1000 requests per minute) |
Categories | build |
Query Parameters
- projectionsarray of strings
Comma-separated fields to return in the response.
Path Parameters
- data-store-idstringRequired
Responses
200
application/json
Successful Operation.
- application/jsonobject
application/json properties
- idstring
Only required when updating the resource. Must be null for new resources.
- uristring
- namestring
- tagsarray of strings
- typestringRequired
- ownerIdstring
The value is automatically set by the application.
- spaceIdstring
- versioninteger
Only required when updating the resource. Must be null for new resources.
- tenantIdstring
The value is automatically set by the application. User defined value is ignored.
- createdBystring
The value is automatically set by the application. User defined value is ignored.
- propertiesobject
A Map of name-value pairs.
- createdTimestring
The value is automatically set by the application. User defined value is ignored.
- descriptionstring
- technicalNamestringRequired
- lastModifiedBystring
The value is automatically set by the application. User defined value is ignored.
- lastModifiedTimestring
The value is automatically set by the application. User defined value is ignored.
- technicalDescriptionstring
-
400
application/json
The request is in incorrect format.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
401
application/json
User does not have valid authentication credentials.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
403
application/json
User does not have access to the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
409
application/json
The input request conflicts with the current state of the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
500
application/json
Internal Server Error.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
503
application/json
Requested service is not available.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/data-stores/{data-store-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-stores/{data-store-id}',
'method': 'GET',
'headers': {
'Authorization': 'Bearer <access_token>'
}
}
const req = https.request(options)
This API is not included yet in qlik-cli
Response
{
"id": "string",
"uri": "string",
"name": "string",
"tags": [
"string"
],
"type": "string",
"ownerId": "string",
"spaceId": "string",
"version": 42,
"tenantId": "string",
"createdBy": "string",
"properties": {},
"createdTime": "2018-10-30T07:06:22Z",
"description": "string",
"technicalName": "string",
"lastModifiedBy": "string",
"lastModifiedTime": "2018-10-30T07:06:22Z",
"technicalDescription": "string"
}
Facts
Rate limit | Tier 2 (100 requests per minute) |
Categories | build |
Path Parameters
- data-store-idstringRequired
Request Body
Requiredapplication/json
Array of JSON patch documents as defined by RFC 6902.
- application/jsonarray of objects
Array of JSON patch documents as defined by RFC 6902.
application/json properties
- opstringRequired
The operation to be performed.
Can be one of: "add""remove""replace""move""copy""test"
- fromstring
A JSON Pointer path pointing to the location to move/copy from.
- pathstringRequired
A JSON pointer to the property being affected.
- valueobject
The value to add, replace or test.
-
Responses
200
application/json
Patched data store successfully.
- application/jsonobject
application/json properties
- idstring
Only required when updating the resource. Must be null for new resources.
- uristring
- namestring
- tagsarray of strings
- typestringRequired
- ownerIdstring
The value is automatically set by the application.
- spaceIdstring
- versioninteger
Only required when updating the resource. Must be null for new resources.
- tenantIdstring
The value is automatically set by the application. User defined value is ignored.
- createdBystring
The value is automatically set by the application. User defined value is ignored.
- propertiesobject
A Map of name-value pairs.
- createdTimestring
The value is automatically set by the application. User defined value is ignored.
- descriptionstring
- technicalNamestringRequired
- lastModifiedBystring
The value is automatically set by the application. User defined value is ignored.
- lastModifiedTimestring
The value is automatically set by the application. User defined value is ignored.
- technicalDescriptionstring
-
204
application/json
Patched data store successfully.
- application/jsonobject
application/json properties
- idstring
Only required when updating the resource. Must be null for new resources.
- uristring
- namestring
- tagsarray of strings
- typestringRequired
- ownerIdstring
The value is automatically set by the application.
- spaceIdstring
- versioninteger
Only required when updating the resource. Must be null for new resources.
- tenantIdstring
The value is automatically set by the application. User defined value is ignored.
- createdBystring
The value is automatically set by the application. User defined value is ignored.
- propertiesobject
A Map of name-value pairs.
- createdTimestring
The value is automatically set by the application. User defined value is ignored.
- descriptionstring
- technicalNamestringRequired
- lastModifiedBystring
The value is automatically set by the application. User defined value is ignored.
- lastModifiedTimestring
The value is automatically set by the application. User defined value is ignored.
- technicalDescriptionstring
-
400
application/json
The request is in incorrect format.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
401
application/json
User does not have valid authentication credentials.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
403
application/json
User does not have access to the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
409
application/json
The input request conflicts with the current state of the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
500
application/json
Internal Server Error.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
503
application/json
Requested service is not available.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/data-stores/{data-store-id}" \
-X PATCH \
-H "Content-type: application/json" \
-H "Authorization: Bearer <access_token>" \
-d '[{"op":"add","from":"string","path":"string","value":{}}]'
const https = require('https')
const data = JSON.stringify([{"op":"add","from":"string","path":"string","value":{}}])
const options = {
'hostname': 'https://your-tenant.us.qlikcloud.com',
'port': 443,
'path': '/api/v1/data-stores/{data-store-id}',
'method': 'PATCH',
'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
[
{
"op": "add",
"from": "string",
"path": "string",
"value": {}
}
]
Response
{
"id": "string",
"uri": "string",
"name": "string",
"tags": [
"string"
],
"type": "string",
"ownerId": "string",
"spaceId": "string",
"version": 42,
"tenantId": "string",
"createdBy": "string",
"properties": {},
"createdTime": "2018-10-30T07:06:22Z",
"description": "string",
"technicalName": "string",
"lastModifiedBy": "string",
"lastModifiedTime": "2018-10-30T07:06:22Z",
"technicalDescription": "string"
}
Facts
Rate limit | Tier 2 (100 requests per minute) |
Categories | build |
Path Parameters
- data-store-idstringRequired
Request Body
Requiredapplication/json
- application/jsonobject
application/json properties
- idstring
Only required when updating the resource. Must be null for new resources.
- uristring
- namestring
- tagsarray of strings
- typestringRequired
- ownerIdstring
The value is automatically set by the application.
- spaceIdstring
- versioninteger
Only required when updating the resource. Must be null for new resources.
- propertiesobject
A Map of name-value pairs.
- descriptionstring
- technicalNamestringRequired
- technicalDescriptionstring
-
Responses
200
application/json
Updated data store successfully.
- application/jsonobject
application/json properties
- idstring
Only required when updating the resource. Must be null for new resources.
- uristring
- namestring
- tagsarray of strings
- typestringRequired
- ownerIdstring
The value is automatically set by the application.
- spaceIdstring
- versioninteger
Only required when updating the resource. Must be null for new resources.
- tenantIdstring
The value is automatically set by the application. User defined value is ignored.
- createdBystring
The value is automatically set by the application. User defined value is ignored.
- propertiesobject
A Map of name-value pairs.
- createdTimestring
The value is automatically set by the application. User defined value is ignored.
- descriptionstring
- technicalNamestringRequired
- lastModifiedBystring
The value is automatically set by the application. User defined value is ignored.
- lastModifiedTimestring
The value is automatically set by the application. User defined value is ignored.
- technicalDescriptionstring
-
400
application/json
The request is in incorrect format.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
401
application/json
User does not have valid authentication credentials.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
403
application/json
User does not have access to the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
409
application/json
The input request conflicts with the current state of the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
500
application/json
Internal Server Error.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
503
application/json
Requested service is not available.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/data-stores/{data-store-id}" \
-X PUT \
-H "Content-type: application/json" \
-H "Authorization: Bearer <access_token>" \
-d '{"id":"string","uri":"string","name":"string","tags":["string"],"type":"string","ownerId":"string","spaceId":"string","version":42,"properties":{},"description":"string","technicalName":"string","technicalDescription":"string"}'
const https = require('https')
const data = JSON.stringify({"id":"string","uri":"string","name":"string","tags":["string"],"type":"string","ownerId":"string","spaceId":"string","version":42,"properties":{},"description":"string","technicalName":"string","technicalDescription":"string"})
const options = {
'hostname': 'https://your-tenant.us.qlikcloud.com',
'port': 443,
'path': '/api/v1/data-stores/{data-store-id}',
'method': 'PUT',
'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
{
"id": "string",
"uri": "string",
"name": "string",
"tags": [
"string"
],
"type": "string",
"ownerId": "string",
"spaceId": "string",
"version": 42,
"properties": {},
"description": "string",
"technicalName": "string",
"technicalDescription": "string"
}
Response
{
"id": "string",
"uri": "string",
"name": "string",
"tags": [
"string"
],
"type": "string",
"ownerId": "string",
"spaceId": "string",
"version": 42,
"tenantId": "string",
"createdBy": "string",
"properties": {},
"createdTime": "2018-10-30T07:06:22Z",
"description": "string",
"technicalName": "string",
"lastModifiedBy": "string",
"lastModifiedTime": "2018-10-30T07:06:22Z",
"technicalDescription": "string"
}
Facts
Rate limit | Tier 1 (1000 requests per minute) |
Categories | build |
Query Parameters
- limitinteger
Page size limit.
- pageinteger
- projectionsarray of strings
Comma-separated fields to return in the response.
- sortarray of strings
Comma-separated fields and field start with '-' character sorts the result set in descending order.
Path Parameters
- data-store-idsarray of stringsRequired
Comma-separated data store IDs or * to include all data stores.
Responses
200
application/json
Successful Operation
- application/jsonobject
application/json properties
- dataarray of objects
data properties
- idstring
Only required when updating the resource. Must be null for new resources.
- namestring
- tagsarray of strings
- appIdstring
- appTypestringRequired
- ownerIdstring
The value is automatically set by the application.
- spaceIdstring
- versioninteger
Only required when updating the resource. Must be null for new resources.
- tenantIdstring
The value is automatically set by the application. User defined value is ignored.
- createdBystring
The value is automatically set by the application. User defined value is ignored.
- propertiesobject
A Map of name-value pairs.
- createdTimestring
The value is automatically set by the application. User defined value is ignored.
- descriptionstring
- dataFreshnessstring
The date-time when the source data was last changed
- dataStoreInfoobject
dataStoreInfo properties
- idstringRequired
- namestring
- typestring
-
- technicalNamestringRequired
- lastModifiedBystring
The value is automatically set by the application. User defined value is ignored.
- lastModifiedTimestring
The value is automatically set by the application. User defined value is ignored.
- technicalDescriptionstring
-
- pageinteger
- limitinteger
- linksobject
links properties
- lastobject
last properties
- hrefstring
-
- nextobject
next properties
- hrefstring
-
- prevobject
prev properties
- hrefstring
-
- selfobject
self properties
- hrefstring
-
- firstobject
first properties
- hrefstring
-
-
- pagesinteger
- totalinteger
-
400
application/json
The request is in incorrect format.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
401
application/json
User does not have valid authentication credentials.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
403
application/json
User does not have access to the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
409
application/json
The input request conflicts with the current state of the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
500
application/json
Internal Server Error.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
503
application/json
Requested service is not available.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/data-stores/{data-store-ids}/data-assets" \
-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-stores/{data-store-ids}/data-assets',
'method': 'GET',
'headers': {
'Authorization': 'Bearer <access_token>'
}
}
const req = https.request(options)
This API is not included yet in qlik-cli
Response
{
"data": [
{
"id": "string",
"name": "string",
"tags": [
"string"
],
"appId": "string",
"appType": "string",
"ownerId": "string",
"spaceId": "string",
"version": 42,
"tenantId": "string",
"createdBy": "string",
"properties": {},
"createdTime": "2018-10-30T07:06:22Z",
"description": "string",
"dataFreshness": "2018-10-30T07:06:22Z",
"dataStoreInfo": {
"id": "string",
"name": "string",
"type": "string"
},
"technicalName": "string",
"lastModifiedBy": "string",
"lastModifiedTime": "2018-10-30T07:06:22Z",
"technicalDescription": "string"
}
],
"page": 42,
"limit": 42,
"links": {
"last": {
"href": "string"
},
"next": {
"href": "string"
},
"prev": {
"href": "string"
},
"self": {
"href": "string"
},
"first": {
"href": "string"
}
},
"pages": 42,
"total": 42
}
Facts
Rate limit | Tier 2 (100 requests per minute) |
Categories | build |
Path Parameters
- data-store-idsarray of stringsRequired
Comma-separated data store IDs or * to include all data stores.
Responses
204
Deleted data assets successfully.
400
application/json
The request is in incorrect format.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
401
application/json
User does not have valid authentication credentials.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
403
application/json
User does not have access to the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
409
application/json
The input request conflicts with the current state of the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
500
application/json
Internal Server Error.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
503
application/json
Requested service is not available.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/data-stores/{data-store-ids}/data-assets" \
-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-stores/{data-store-ids}/data-assets',
'method': 'DELETE',
'headers': {
'Authorization': 'Bearer <access_token>'
}
}
const req = https.request(options)
This API is not included yet in qlik-cli
Facts
Rate limit | Tier 1 (1000 requests per minute) |
Categories | build |
Query Parameters
- limitinteger
Page size limit.
- pageinteger
- projectionsarray of strings
Comma-separated fields to return in the response.
- sortarray of strings
Comma-separated fields and field start with '-' character sorts the result set in descending order.
Path Parameters
- data-asset-idsarray of stringsRequired
Comma-separated data asset IDs or * to include all data assets.
- data-store-idsarray of stringsRequired
Comma-separated data store IDs or * to include all data stores.
Responses
200
application/json
Successful Operation.
- application/jsonobject
application/json properties
- dataarray of objects
data properties
- idstring
Only required when updating the resource. Must be null for new resources.
- qristringRequired
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.
- namestring
- tagsarray of strings
- typestring
- schemaobject
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
schema properties
- anomaliesarray of strings
Anomalies associated with this schema. Example: $warning-unknown-headers
- dataFieldsarray of objectsRequired
dataFields properties
- namestringRequired
- tagsarray of strings
An array of system tags
- aliasstring
- indexinteger
- orphanboolean
- dataTypeobjectRequired
dataType properties
- typestringRequired
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.
Can be one of: "DATE""TIME""DATETIME""TIMESTAMP""STRING""DOUBLE""DECIMAL""INTEGER""BOOLEAN""BINARY""CUSTOM"
- propertiesobject
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.
- originalTypestring
-
- nullableboolean
- userTagsarray of objects
An array of user-supplied tags
userTags properties
- idstring
The id of the tag in Collections
- namestring
-
- encryptedboolean
- sensitiveboolean
- primaryKeyboolean
- propertiesobject
- descriptionstring
- ordinalPositionInKeyinteger
-
- schemaNamestring
- loadOptionsobject
Options for loading files. Example: "qLabel": "embedded labels"
- effectiveDatestring
- overrideSchemaAnomaliesboolean
-
- ownerIdstring
The value is automatically set by the application.
- spaceIdstring
- versioninteger
Only required when updating the resource. Must be null for new resources.
- tenantIdstring
The value is automatically set by the application. User defined value is ignored.
- createdBystring
The value is automatically set by the application. User defined value is ignored.
- secureQristringRequired
- propertiesobject
A Map of name-value pairs.
- createdTimestring
The value is automatically set by the application. User defined value is ignored.
- descriptionstring
- operationalobject
operational properties
- sizeinteger
- statusstring
- endDatestring
- locationstring
- rowCountinteger
- startDatestring
- logMessagestring
- tableOwnerstring
- lastLoadTimestring
- contentUpdatedboolean
- lastUpdateTimestring
- tableConnectionInfoobject
tableConnectionInfo properties
- tableNamestring
- selectionScriptstring
- additionalPropertiesobject
-
-
- dataAssetInfoobjectRequired
dataAssetInfo properties
- idstringRequired
- namestring
- dataStoreInfoobject
dataStoreInfo properties
- idstringRequired
- namestring
- typestring
-
-
- technicalNamestringRequired
- lastModifiedBystring
The value is automatically set by the application. User defined value is ignored.
- appTypeOverridestring
Optional override of DataAsset appType.
- lastModifiedTimestring
The value is automatically set by the application. User defined value is ignored.
- additionalSchemasarray of objects
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 properties
- anomaliesarray of strings
Anomalies associated with this schema. Example: $warning-unknown-headers
- dataFieldsarray of objectsRequired
dataFields properties
- namestringRequired
- tagsarray of strings
An array of system tags
- aliasstring
- indexinteger
- orphanboolean
- dataTypeobjectRequired
dataType properties
- typestringRequired
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.
Can be one of: "DATE""TIME""DATETIME""TIMESTAMP""STRING""DOUBLE""DECIMAL""INTEGER""BOOLEAN""BINARY""CUSTOM"
- propertiesobject
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.
- originalTypestring
-
- nullableboolean
- userTagsarray of objects
An array of user-supplied tags
userTags properties
- idstring
The id of the tag in Collections
- namestring
-
- encryptedboolean
- sensitiveboolean
- primaryKeyboolean
- propertiesobject
- descriptionstring
- ordinalPositionInKeyinteger
-
- schemaNamestring
- loadOptionsobject
Options for loading files. Example: "qLabel": "embedded labels"
- effectiveDatestring
- overrideSchemaAnomaliesboolean
-
- technicalDescriptionstring
- createdByConnectionIdstring
The connectionId that created the Dataset. Optional.
-
- pageinteger
- limitinteger
- linksobject
links properties
- lastobject
last properties
- hrefstring
-
- nextobject
next properties
- hrefstring
-
- prevobject
prev properties
- hrefstring
-
- selfobject
self properties
- hrefstring
-
- firstobject
first properties
- hrefstring
-
-
- pagesinteger
- totalinteger
-
400
application/json
The request is in incorrect format.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
401
application/json
User does not have valid authentication credentials.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
403
application/json
User does not have access to the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
409
application/json
The input request conflicts with the current state of the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
500
application/json
Internal Server Error.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
503
application/json
Requested service is not available.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/data-stores/{data-store-ids}/data-assets/{data-asset-ids}/data-sets" \
-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-stores/{data-store-ids}/data-assets/{data-asset-ids}/data-sets',
'method': 'GET',
'headers': {
'Authorization': 'Bearer <access_token>'
}
}
const req = https.request(options)
This API is not included yet in qlik-cli
Response
{
"data": [
{
"id": "string",
"qri": "string",
"name": "string",
"tags": [
"string"
],
"type": "string",
"schema": {
"anomalies": [
"string"
],
"dataFields": [
{
"name": "string",
"tags": [
"string"
],
"alias": "string",
"index": 42,
"orphan": true,
"dataType": {
"type": "DATE",
"properties": {},
"originalType": "string"
},
"nullable": true,
"userTags": [
{
"id": "string",
"name": "string"
}
],
"encrypted": true,
"sensitive": true,
"primaryKey": true,
"properties": {},
"description": "string",
"ordinalPositionInKey": 42
}
],
"schemaName": "string",
"loadOptions": {},
"effectiveDate": "2018-10-30T07:06:22Z",
"overrideSchemaAnomalies": true
},
"ownerId": "string",
"spaceId": "string",
"version": 42,
"tenantId": "string",
"createdBy": "string",
"secureQri": "string",
"properties": {},
"createdTime": "2018-10-30T07:06:22Z",
"description": "string",
"operational": {
"size": 42,
"status": "string",
"endDate": "2018-10-30T07:06:22Z",
"location": "string",
"rowCount": 42,
"startDate": "2018-10-30T07:06:22Z",
"logMessage": "string",
"tableOwner": "string",
"lastLoadTime": "2018-10-30T07:06:22Z",
"contentUpdated": true,
"lastUpdateTime": "2018-10-30T07:06:22Z",
"tableConnectionInfo": {
"tableName": "string",
"selectionScript": "string",
"additionalProperties": {}
}
},
"dataAssetInfo": {
"id": "string",
"name": "string",
"dataStoreInfo": {
"id": "string",
"name": "string",
"type": "string"
}
},
"technicalName": "string",
"lastModifiedBy": "string",
"appTypeOverride": "string",
"lastModifiedTime": "2018-10-30T07:06:22Z",
"additionalSchemas": [
{
"anomalies": [
"string"
],
"dataFields": [
{
"name": "string",
"tags": [
"string"
],
"alias": "string",
"index": 42,
"orphan": true,
"dataType": {
"type": "DATE",
"properties": {},
"originalType": "string"
},
"nullable": true,
"userTags": [
{
"id": "string",
"name": "string"
}
],
"encrypted": true,
"sensitive": true,
"primaryKey": true,
"properties": {},
"description": "string",
"ordinalPositionInKey": 42
}
],
"schemaName": "string",
"loadOptions": {},
"effectiveDate": "2018-10-30T07:06:22Z",
"overrideSchemaAnomalies": true
}
],
"technicalDescription": "string",
"createdByConnectionId": "string"
}
],
"page": 42,
"limit": 42,
"links": {
"last": {
"href": "string"
},
"next": {
"href": "string"
},
"prev": {
"href": "string"
},
"self": {
"href": "string"
},
"first": {
"href": "string"
}
},
"pages": 42,
"total": 42
}
Facts
Rate limit | Tier 2 (100 requests per minute) |
Categories | build |
Path Parameters
- data-asset-idsarray of stringsRequired
Comma-separated data asset IDs or * to include all data assets.
- data-store-idsarray of stringsRequired
Comma-separated data store IDs or * to include all data stores.
Responses
204
Deleted data sets.
400
application/json
The request is in incorrect format.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
401
application/json
User does not have valid authentication credentials.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
403
application/json
User does not have access to the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
404
application/json
Resource does not exist.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
409
application/json
The input request conflicts with the current state of the resource.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
500
application/json
Internal Server Error.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
503
application/json
Requested service is not available.
- application/jsonobject
application/json properties
- errorsarray of objects
errors properties
- codestring
- titlestring
- detailstring
- statusstring
-
- traceIdstring
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/data-stores/{data-store-ids}/data-assets/{data-asset-ids}/data-sets" \
-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-stores/{data-store-ids}/data-assets/{data-asset-ids}/data-sets',
'method': 'DELETE',
'headers': {
'Authorization': 'Bearer <access_token>'
}
}
const req = https.request(options)
This API is not included yet in qlik-cli