Items

Items provides a list of core resources in the Qlik platform, including resources such as apps, automations, and data sets that a user has access to.

Download OpenAPI spec

Endpoints

GET

/api/v1/items
GET

/api/v1/items/{itemId}
PUT

/api/v1/items/{itemId}
DELETE

/api/v1/items/{itemId}
GET

/api/v1/items/{itemId}/collections
GET

/api/v1/items/{itemId}/publisheditems
GET

/api/v1/items/settings
PATCH

/api/v1/items/settings

Lists items that the user has access to.

Facts

Rate limit

Tier 1 (1000 requests per minute)

Query Parameters

collectionId string

The collection's unique identifier. Used to filter for items with a specific tag (collection type public), or collection.
createdByUserId string

User's unique identifier.
id string

The item's unique identifier.
limit integer

The maximum number of resources to return for a request. The limit must be an integer between 1 and 100 (inclusive).

minimum = 1, maximum = 100, default = 10, default = 10
name string

The case-insensitive string used to search for a resource by name.
next string

The cursor to the next page of resources. Provide either the next or prev cursor, but not both.
notCreatedByUserId string

User's unique identifier.
notOwnerId string

Owner identifier.
ownerId string

Owner identifier.
prev string

The cursor to the previous page of resources. Provide either the next or prev cursor, but not both.
query string

The case-insensitive string used to search for a resource by name or description.
resourceId string

The case-sensitive string used to search for an item by resourceId. If resourceId is provided, then resourceType must be provided. Provide either the resourceId or resourceLink, but not both.
resourceIds string

The case-sensitive strings used to search for an item by resourceIds. The maximum number of resourceIds it supports is 100. If resourceIds is provided, then resourceType must be provided. For example '?resourceIds=appId1,appId2'
resourceLink string

The case-sensitive string used to search for an item by resourceLink. If resourceLink is provided, then resourceType must be provided. Provide either the resourceId or resourceLink, but not both.

format = "uri"
resourceSubType string

the case-sensitive string used to filter items by resourceSubType(s). For example '?resourceSubType=chart-monitoring,qix-df,qvd'. Will return a 400 error if used in conjuction with the square bracket syntax for resourceSubType filtering in the 'resourceType' query parameter.
resourceType string

The case-sensitive string used to filter items by resourceType(s). For example '?resourceType=app,qvapp'. Additionally, a optional resourceSubType filter can be added to each resourceType. For example '?resourceType=app[qvd,chart-monitoring],qvapp'. An trailing comma can be used to include the empty resourceSubType, e.g. '?resourceType=app[qvd,chart-monitoring,]', or, to include only empty resourceSubTypes, '?resourceType=app[]' This syntax replaces the 'resourceSubType' query param, and using both in the same query will result in a 400 error.

Can be one of: "app""qlikview""qvapp""genericlink""sharingservicetask""note""dataasset""dataset""automation""automl-experiment""automl-deployment""assistant""dataproduct""dataqualityrule""glossary""knowledgebase""script""semantictype""page"
sort string

The property of a resource to sort on (default sort is +createdAt). The supported properties are createdAt, updatedAt, recentlyUsed and name. A property must be prefixed by + or - to indicate ascending or descending sort order respectively.

Can be one of: "+createdAt""-createdAt""+name""-name""+updatedAt""-updatedAt""+recentlyUsed""-recentlyUsed"
spaceId string

The space's unique identifier (supports 'personal' as spaceId).
spaceType string

The case-sensitive string used to filter items on space type(s). For example '?spaceType=shared,personal'.

Can be one of: "shared""managed""personal""data"
shared boolean Deprecated

Whether or not to return items in a shared space.
noActions boolean

If set to true, the user's available actions for each item will not be evaluated meaning the actions-array will be omitted from the response (reduces response time).

default = false

Responses

200

OK response.

application/json object

ListItemsResponseBody result type
Show application/json properties
- data array of objects
  
  Required
  
  An item.
  
  Show data properties
  
  id string
  
  Required
  
  The item's unique identifier.
  
  meta object
  
  Required
  
  Item metadata and computed fields.
  
  Show meta properties
  
  tags array of objects
  
  Required
  
  An array of tags that the item is part of.
  
  Show tags properties
  
  id string
  
  Required
  
  The ID of the tag/collection.
  
  name string
  
  Required
  
  The name of the tag/collection.
  
  actions array of strings
  
  Required
  
  The actions that the user can perform on the item.
  
  collections array of objects
  
  Required
  
  An array of collections that the item is part of.
  
  Show collections properties
  
  id string
  
  Required
  
  The ID of the tag/collection.
  
  name string
  
  Required
  
  The name of the tag/collection.
  
  isFavorited boolean
  
  Required
  
  The flag that indicates if item is in the user's favorites collection.
  
  name string
  
  Required
  
  minLength = 1
  
  links object
  
  Required
  
  Show links properties
  
  open object
  
  Show open properties
  
  href string
  
  format = "uri"
  
  self object
  
  Show self properties
  
  href string
  
  format = "uri"
  
  qvPlugin object
  
  Show qvPlugin properties
  
  href string
  
  format = "uri"
  
  thumbnail object
  
  Show thumbnail properties
  
  href string
  
  format = "uri"
  
  collections object
  
  Show collections properties
  
  href string
  
  format = "uri"
  
  actions array of strings
  
  Required
  
  The actions that the user can perform on the item.
  
  ownerId string
  
  The ID of the user who owns the item.
  
  spaceId string
  
  The space's unique identifier.
  
  tenantId string
  
  Required
  
  The ID of the tenant that owns the item. This is populated using the JWT.
  
  createdAt string
  
  Required
  
  The RFC3339 datetime when the item was created.
  
  format = "date-time"
  
  creatorId string
  
  The ID of the user who created the item. This is only populated if the JWT contains a userId.
  
  itemViews object
  
  Show itemViews properties
  
  week array of objects
  
  Show week properties
  
  start string
  
  The RFC3339 datetime representing the start of the referenced week.
  
  format = "date-time"
  
  total integer
  
  Total number of views the resource got during the referenced week.
  
  unique integer
  
  Number of unique users who viewed the resource during the referenced week.
  
  total integer
  
  Total number of views the resource got during the last 28 days.
  
  trend number
  
  Trend in views over the last 4 weeks. The trend value is a float number representing a linear regression slope (the x-coefficient) calculated from the weekly unique users views in the preceding 4 weeks.
  
  unique integer
  
  Number of unique users who viewed the resource during the last 28 days.
  
  usedBy integer
  
  Number of apps this dataset is used in (datasets only).
  
  updatedAt string
  
  Required
  
  The RFC3339 datetime when the item was last updated.
  
  format = "date-time"
  
  updaterId string
  
  ID of the user who last updated the item. This is only populated if the JWT contains a userId.
  
  resourceId string
  
  The case-sensitive string used to search for an item by resourceId. If resourceId is provided, then resourceType must be provided. Provide either the resourceId or resourceLink, but not both.
  
  description string
  
  isFavorited boolean
  
  Required
  
  The flag that indicates if item is in the user's favorites collection.
  
  thumbnailId string
  
  The item thumbnail's unique identifier. This is optional for internal resources.
  
  resourceLink string
  
  The case-sensitive string used to search for an item by resourceLink. If resourceLink is provided, then resourceType must be provided. Provide either the resourceId or resourceLink, but not both.
  
  format = "uri"
  
  resourceSize object
  
  Show resourceSize properties
  
  appFile number
  
  Size of the app on disk in bytes.
  
  appMemory number
  
  Size of the app in memory in bytes.
  
  resourceType string
  
  Required
  
  The case-sensitive string defining the item's type.
  
  Can be one of: "app""qlikview""qvapp""genericlink""sharingservicetask""note""dataasset""dataset""automation""automl-experiment""automl-deployment""assistant""dataproduct""dataqualityrule""glossary""knowledgebase""script""semantictype""page"
  
  collectionIds array of strings
  
  Required
  
  The ID of the collections that the item has been added to.
  
  resourceSubType string
  
  Optional field defining the item's subtype, if any.
  
  resourceCreatedAt string
  
  Required
  
  The RFC3339 datetime when the resource that the item references was created.
  
  format = "date-time"
  
  resourceUpdatedAt string
  
  Required
  
  The RFC3339 datetime when the resource that the item references was last updated.
  
  format = "date-time"
  
  resourceAttributes object
  
  Required
  
  additionalProperties = true
  
  resourceReloadStatus string
  
  If the resource last reload was successful or not.
  
  resourceReloadEndTime string
  
  The RFC3339 datetime when the resource last reload ended.
  
  format = "date-time"
  
  resourceCustomAttributes object
  
  Required
  
  additionalProperties = true
- links object
  
  Required
  
  Show links properties
  
  next object
  
  Show next properties
  
  href string
  
  format = "uri"
  
  prev object
  
  Show prev properties
  
  href string
  
  format = "uri"
  
  self object
  
  Show self properties
  
  href string
  
  format = "uri"
  
  collection object
  
  Show collection properties
  
  href string
  
  format = "uri"

400

Bad Request response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

401

Unauthorized response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

404

Not Found response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

500

Internal Server Error response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

GET /api/v1/items

import { createQlikApi } from '@qlik/api'

const qlik = createQlikApi({
  hostConfig: {
    host: 'https://{tenant}.{region}.qlikcloud.com',
    apiKey: '<access-token>',
  },
})

await qlik.items.getItems({})

qlik item ls

curl "https://{tenant}.{region}.qlikcloud.com/api/v1/items" \
-H "Authorization: Bearer <access_token>"

Example Response

{
  "data": [
    {
      "id": "string",
      "meta": {
        "tags": [
          {
            "id": "string",
            "name": "string"
          }
        ],
        "actions": [
          "string"
        ],
        "collections": [
          {
            "id": "string",
            "name": "string"
          }
        ],
        "isFavorited": true
      },
      "name": "string",
      "links": {
        "open": {
          "href": "string"
        },
        "self": {
          "href": "string"
        },
        "qvPlugin": {
          "href": "string"
        },
        "thumbnail": {
          "href": "string"
        },
        "collections": {
          "href": "string"
        }
      },
      "actions": [
        "string"
      ],
      "ownerId": "string",
      "spaceId": "string",
      "tenantId": "string",
      "createdAt": "2018-10-30T07:06:22Z",
      "creatorId": "string",
      "itemViews": {
        "week": [
          {
            "start": "2018-10-30T07:06:22Z",
            "total": 42,
            "unique": 42
          }
        ],
        "total": 42,
        "trend": -4.2,
        "unique": 42,
        "usedBy": 42
      },
      "updatedAt": "2018-10-30T07:06:22Z",
      "updaterId": "string",
      "resourceId": "string",
      "description": "string",
      "isFavorited": true,
      "thumbnailId": "string",
      "resourceLink": "string",
      "resourceSize": {
        "appFile": 42,
        "appMemory": 42
      },
      "resourceType": "app",
      "collectionIds": [
        "string"
      ],
      "resourceSubType": "string",
      "resourceCreatedAt": "2018-10-30T07:06:22Z",
      "resourceUpdatedAt": "2018-10-30T07:06:22Z",
      "resourceAttributes": {},
      "resourceReloadStatus": "string",
      "resourceReloadEndTime": "2018-10-30T07:06:22Z",
      "resourceCustomAttributes": {}
    }
  ],
  "links": {
    "next": {
      "href": "string"
    },
    "prev": {
      "href": "string"
    },
    "self": {
      "href": "string"
    },
    "collection": {
      "href": "string"
    }
  }
}

Finds and returns an item.

Facts

Rate limit

Tier 1 (1000 requests per minute)

Path Parameters

itemId string

Required

The item's unique identifier

Responses

200

OK response.

application/json object

An item.
Show application/json properties
- id string
  
  Required
  
  The item's unique identifier.
- meta object
  
  Required
  
  Item metadata and computed fields.
  
  Show meta properties
  
  tags array of objects
  
  Required
  
  An array of tags that the item is part of.
  
  Show tags properties
  
  id string
  
  Required
  
  The ID of the tag/collection.
  
  name string
  
  Required
  
  The name of the tag/collection.
  
  actions array of strings
  
  Required
  
  The actions that the user can perform on the item.
  
  collections array of objects
  
  Required
  
  An array of collections that the item is part of.
  
  Show collections properties
  
  id string
  
  Required
  
  The ID of the tag/collection.
  
  name string
  
  Required
  
  The name of the tag/collection.
  
  isFavorited boolean
  
  Required
  
  The flag that indicates if item is in the user's favorites collection.
- name string
  
  Required
  
  minLength = 1
- links object
  
  Required
  
  Show links properties
  
  open object
  
  Show open properties
  
  href string
  
  format = "uri"
  
  self object
  
  Show self properties
  
  href string
  
  format = "uri"
  
  qvPlugin object
  
  Show qvPlugin properties
  
  href string
  
  format = "uri"
  
  thumbnail object
  
  Show thumbnail properties
  
  href string
  
  format = "uri"
  
  collections object
  
  Show collections properties
  
  href string
  
  format = "uri"
- actions array of strings
  
  Required
  
  The actions that the user can perform on the item.
- ownerId string
  
  The ID of the user who owns the item.
- spaceId string
  
  The space's unique identifier.
- tenantId string
  
  Required
  
  The ID of the tenant that owns the item. This is populated using the JWT.
- createdAt string
  
  Required
  
  The RFC3339 datetime when the item was created.
  
  format = "date-time"
- creatorId string
  
  The ID of the user who created the item. This is only populated if the JWT contains a userId.
- itemViews object
  
  Show itemViews properties
  
  week array of objects
  
  Show week properties
  
  start string
  
  The RFC3339 datetime representing the start of the referenced week.
  
  format = "date-time"
  
  total integer
  
  Total number of views the resource got during the referenced week.
  
  unique integer
  
  Number of unique users who viewed the resource during the referenced week.
  
  total integer
  
  Total number of views the resource got during the last 28 days.
  
  trend number
  
  Trend in views over the last 4 weeks. The trend value is a float number representing a linear regression slope (the x-coefficient) calculated from the weekly unique users views in the preceding 4 weeks.
  
  unique integer
  
  Number of unique users who viewed the resource during the last 28 days.
  
  usedBy integer
  
  Number of apps this dataset is used in (datasets only).
- updatedAt string
  
  Required
  
  The RFC3339 datetime when the item was last updated.
  
  format = "date-time"
- updaterId string
  
  ID of the user who last updated the item. This is only populated if the JWT contains a userId.
- resourceId string
  
  The case-sensitive string used to search for an item by resourceId. If resourceId is provided, then resourceType must be provided. Provide either the resourceId or resourceLink, but not both.
- description string
- isFavorited boolean
  
  Required
  
  The flag that indicates if item is in the user's favorites collection.
- thumbnailId string
  
  The item thumbnail's unique identifier. This is optional for internal resources.
- resourceLink string
  
  The case-sensitive string used to search for an item by resourceLink. If resourceLink is provided, then resourceType must be provided. Provide either the resourceId or resourceLink, but not both.
  
  format = "uri"
- resourceSize object
  
  Show resourceSize properties
  
  appFile number
  
  Size of the app on disk in bytes.
  
  appMemory number
  
  Size of the app in memory in bytes.
- resourceType string
  
  Required
  
  The case-sensitive string defining the item's type.
  
  Can be one of: "app""qlikview""qvapp""genericlink""sharingservicetask""note""dataasset""dataset""automation""automl-experiment""automl-deployment""assistant""dataproduct""dataqualityrule""glossary""knowledgebase""script""semantictype""page"
- collectionIds array of strings
  
  Required
  
  The ID of the collections that the item has been added to.
- resourceSubType string
  
  Optional field defining the item's subtype, if any.
- resourceCreatedAt string
  
  Required
  
  The RFC3339 datetime when the resource that the item references was created.
  
  format = "date-time"
- resourceUpdatedAt string
  
  Required
  
  The RFC3339 datetime when the resource that the item references was last updated.
  
  format = "date-time"
- resourceAttributes object
  
  Required
  
  additionalProperties = true
- resourceReloadStatus string
  
  If the resource last reload was successful or not.
- resourceReloadEndTime string
  
  The RFC3339 datetime when the resource last reload ended.
  
  format = "date-time"
- resourceCustomAttributes object
  
  Required
  
  additionalProperties = true

400

Bad Request response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

401

Unauthorized response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

404

Not Found response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

500

Internal Server Error response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

GET /api/v1/items/{itemId}

import { createQlikApi } from '@qlik/api'

const qlik = createQlikApi({
  hostConfig: {
    host: 'https://{tenant}.{region}.qlikcloud.com',
    apiKey: '<access-token>',
  },
})

await qlik.items.getItem('string')

qlik item get 'string'

curl "https://{tenant}.{region}.qlikcloud.com/api/v1/items/{itemId}" \
-H "Authorization: Bearer <access_token>"

Example Response

{
  "id": "string",
  "meta": {
    "tags": [
      {
        "id": "string",
        "name": "string"
      }
    ],
    "actions": [
      "string"
    ],
    "collections": [
      {
        "id": "string",
        "name": "string"
      }
    ],
    "isFavorited": true
  },
  "name": "string",
  "links": {
    "open": {
      "href": "string"
    },
    "self": {
      "href": "string"
    },
    "qvPlugin": {
      "href": "string"
    },
    "thumbnail": {
      "href": "string"
    },
    "collections": {
      "href": "string"
    }
  },
  "actions": [
    "string"
  ],
  "ownerId": "string",
  "spaceId": "string",
  "tenantId": "string",
  "createdAt": "2018-10-30T07:06:22Z",
  "creatorId": "string",
  "itemViews": {
    "week": [
      {
        "start": "2018-10-30T07:06:22Z",
        "total": 42,
        "unique": 42
      }
    ],
    "total": 42,
    "trend": -4.2,
    "unique": 42,
    "usedBy": 42
  },
  "updatedAt": "2018-10-30T07:06:22Z",
  "updaterId": "string",
  "resourceId": "string",
  "description": "string",
  "isFavorited": true,
  "thumbnailId": "string",
  "resourceLink": "string",
  "resourceSize": {
    "appFile": 42,
    "appMemory": 42
  },
  "resourceType": "app",
  "collectionIds": [
    "string"
  ],
  "resourceSubType": "string",
  "resourceCreatedAt": "2018-10-30T07:06:22Z",
  "resourceUpdatedAt": "2018-10-30T07:06:22Z",
  "resourceAttributes": {},
  "resourceReloadStatus": "string",
  "resourceReloadEndTime": "2018-10-30T07:06:22Z",
  "resourceCustomAttributes": {}
}

Updates an item. Omitted and unsupported fields are ignored. To unset a field, provide the field's zero value.

Facts

Rate limit

Tier 2 (100 requests per minute)

Path Parameters

itemId string

Required

The item's unique identifier.

Request Body

Required

application/json object
Show application/json properties
- name string
  
  minLength = 1
- spaceId string
  
  The space's unique identifier.
- resourceId string
  
  The case-sensitive string used to search for an item by resourceId. If resourceId is provided, then resourceType must be provided. Provide either the resourceId or resourceLink, but not both.
- description string
- thumbnailId string
  
  The item thumbnail's unique identifier. This is optional for internal resources.
- resourceLink string
  
  The case-sensitive string used to search for an item by resourceLink. If resourceLink is provided, then resourceType must be provided. Provide either the resourceId or resourceLink, but not both.
  
  format = "uri"
- resourceType string
  
  Required
  
  The case-sensitive string defining the item's type.
  
  Can be one of: "app""qlikview""qvapp""genericlink""sharingservicetask""note""dataasset""dataset""automation""automl-experiment""automl-deployment""assistant""dataproduct""dataqualityrule""glossary""knowledgebase""script""semantictype""page"
- resourceSubType string
  
  Optional field defining the item's subtype, if any.
- resourceUpdatedAt string
  
  The RFC3339 datetime when the resource that the item references was last updated.
  
  format = "date-time"
- resourceAttributes object
  
  additionalProperties = true
- resourceCustomAttributes object
  
  additionalProperties = true

Responses

200

OK response.

application/json object

An item.
Show application/json properties
- id string
  
  Required
  
  The item's unique identifier.
- meta object
  
  Required
  
  Item metadata and computed fields.
  
  Show meta properties
  
  tags array of objects
  
  Required
  
  An array of tags that the item is part of.
  
  Show tags properties
  
  id string
  
  Required
  
  The ID of the tag/collection.
  
  name string
  
  Required
  
  The name of the tag/collection.
  
  actions array of strings
  
  Required
  
  The actions that the user can perform on the item.
  
  collections array of objects
  
  Required
  
  An array of collections that the item is part of.
  
  Show collections properties
  
  id string
  
  Required
  
  The ID of the tag/collection.
  
  name string
  
  Required
  
  The name of the tag/collection.
  
  isFavorited boolean
  
  Required
  
  The flag that indicates if item is in the user's favorites collection.
- name string
  
  Required
  
  minLength = 1
- links object
  
  Required
  
  Show links properties
  
  open object
  
  Show open properties
  
  href string
  
  format = "uri"
  
  self object
  
  Show self properties
  
  href string
  
  format = "uri"
  
  qvPlugin object
  
  Show qvPlugin properties
  
  href string
  
  format = "uri"
  
  thumbnail object
  
  Show thumbnail properties
  
  href string
  
  format = "uri"
  
  collections object
  
  Show collections properties
  
  href string
  
  format = "uri"
- actions array of strings
  
  Required
  
  The actions that the user can perform on the item.
- ownerId string
  
  The ID of the user who owns the item.
- spaceId string
  
  The space's unique identifier.
- tenantId string
  
  Required
  
  The ID of the tenant that owns the item. This is populated using the JWT.
- createdAt string
  
  Required
  
  The RFC3339 datetime when the item was created.
  
  format = "date-time"
- creatorId string
  
  The ID of the user who created the item. This is only populated if the JWT contains a userId.
- itemViews object
  
  Show itemViews properties
  
  week array of objects
  
  Show week properties
  
  start string
  
  The RFC3339 datetime representing the start of the referenced week.
  
  format = "date-time"
  
  total integer
  
  Total number of views the resource got during the referenced week.
  
  unique integer
  
  Number of unique users who viewed the resource during the referenced week.
  
  total integer
  
  Total number of views the resource got during the last 28 days.
  
  trend number
  
  Trend in views over the last 4 weeks. The trend value is a float number representing a linear regression slope (the x-coefficient) calculated from the weekly unique users views in the preceding 4 weeks.
  
  unique integer
  
  Number of unique users who viewed the resource during the last 28 days.
  
  usedBy integer
  
  Number of apps this dataset is used in (datasets only).
- updatedAt string
  
  Required
  
  The RFC3339 datetime when the item was last updated.
  
  format = "date-time"
- updaterId string
  
  ID of the user who last updated the item. This is only populated if the JWT contains a userId.
- resourceId string
  
  The case-sensitive string used to search for an item by resourceId. If resourceId is provided, then resourceType must be provided. Provide either the resourceId or resourceLink, but not both.
- description string
- isFavorited boolean
  
  Required
  
  The flag that indicates if item is in the user's favorites collection.
- thumbnailId string
  
  The item thumbnail's unique identifier. This is optional for internal resources.
- resourceLink string
  
  The case-sensitive string used to search for an item by resourceLink. If resourceLink is provided, then resourceType must be provided. Provide either the resourceId or resourceLink, but not both.
  
  format = "uri"
- resourceSize object
  
  Show resourceSize properties
  
  appFile number
  
  Size of the app on disk in bytes.
  
  appMemory number
  
  Size of the app in memory in bytes.
- resourceType string
  
  Required
  
  The case-sensitive string defining the item's type.
  
  Can be one of: "app""qlikview""qvapp""genericlink""sharingservicetask""note""dataasset""dataset""automation""automl-experiment""automl-deployment""assistant""dataproduct""dataqualityrule""glossary""knowledgebase""script""semantictype""page"
- collectionIds array of strings
  
  Required
  
  The ID of the collections that the item has been added to.
- resourceSubType string
  
  Optional field defining the item's subtype, if any.
- resourceCreatedAt string
  
  Required
  
  The RFC3339 datetime when the resource that the item references was created.
  
  format = "date-time"
- resourceUpdatedAt string
  
  Required
  
  The RFC3339 datetime when the resource that the item references was last updated.
  
  format = "date-time"
- resourceAttributes object
  
  Required
  
  additionalProperties = true
- resourceReloadStatus string
  
  If the resource last reload was successful or not.
- resourceReloadEndTime string
  
  The RFC3339 datetime when the resource last reload ended.
  
  format = "date-time"
- resourceCustomAttributes object
  
  Required
  
  additionalProperties = true

400

Bad Request response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

401

Unauthorized response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

403

Forbidden response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

404

Not Found response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

409

Conflict response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

500

Internal Server Error response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

PUT /api/v1/items/{itemId}

import { createQlikApi } from '@qlik/api'

const qlik = createQlikApi({
  hostConfig: {
    host: 'https://{tenant}.{region}.qlikcloud.com',
    apiKey: '<access-token>',
  },
})

await qlik.items.updateItem('string', {
  description: 'string',
  name: 'string',
  resourceAttributes: {},
  resourceCustomAttributes: {},
  resourceId: 'string',
  resourceLink: 'string',
  resourceSubType: 'string',
  resourceType: 'app',
  resourceUpdatedAt: '2018-10-30T07:06:22Z',
  spaceId: 'string',
  thumbnailId: 'string',
})

qlik item update 'string' \
  --resourceType 'app'

curl "https://{tenant}.{region}.qlikcloud.com/api/v1/items/{itemId}" \
-X PUT \
-H "Content-type: application/json" \
-H "Authorization: Bearer <access_token>" \
-d '{"name":"string","spaceId":"string","resourceId":"string","description":"string","thumbnailId":"string","resourceLink":"string","resourceType":"app","resourceSubType":"string","resourceUpdatedAt":"2018-10-30T07:06:22Z","resourceAttributes":{},"resourceCustomAttributes":{}}'

Example Response

{
  "id": "string",
  "meta": {
    "tags": [
      {
        "id": "string",
        "name": "string"
      }
    ],
    "actions": [
      "string"
    ],
    "collections": [
      {
        "id": "string",
        "name": "string"
      }
    ],
    "isFavorited": true
  },
  "name": "string",
  "links": {
    "open": {
      "href": "string"
    },
    "self": {
      "href": "string"
    },
    "qvPlugin": {
      "href": "string"
    },
    "thumbnail": {
      "href": "string"
    },
    "collections": {
      "href": "string"
    }
  },
  "actions": [
    "string"
  ],
  "ownerId": "string",
  "spaceId": "string",
  "tenantId": "string",
  "createdAt": "2018-10-30T07:06:22Z",
  "creatorId": "string",
  "itemViews": {
    "week": [
      {
        "start": "2018-10-30T07:06:22Z",
        "total": 42,
        "unique": 42
      }
    ],
    "total": 42,
    "trend": -4.2,
    "unique": 42,
    "usedBy": 42
  },
  "updatedAt": "2018-10-30T07:06:22Z",
  "updaterId": "string",
  "resourceId": "string",
  "description": "string",
  "isFavorited": true,
  "thumbnailId": "string",
  "resourceLink": "string",
  "resourceSize": {
    "appFile": 42,
    "appMemory": 42
  },
  "resourceType": "app",
  "collectionIds": [
    "string"
  ],
  "resourceSubType": "string",
  "resourceCreatedAt": "2018-10-30T07:06:22Z",
  "resourceUpdatedAt": "2018-10-30T07:06:22Z",
  "resourceAttributes": {},
  "resourceReloadStatus": "string",
  "resourceReloadEndTime": "2018-10-30T07:06:22Z",
  "resourceCustomAttributes": {}
}

Deletes an item and removes the item from all collections.

Facts

Rate limit

Tier 2 (100 requests per minute)

Path Parameters

itemId string

Required

The item's unique identifier.

Responses

204

No Content response.

401

Unauthorized response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

403

Forbidden response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

404

Not Found response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

500

Internal Server Error response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

DELETE /api/v1/items/{itemId}

import { createQlikApi } from '@qlik/api'

const qlik = createQlikApi({
  hostConfig: {
    host: 'https://{tenant}.{region}.qlikcloud.com',
    apiKey: '<access-token>',
  },
})

await qlik.items.deleteItem('string')

qlik item rm 'string'

curl "https://{tenant}.{region}.qlikcloud.com/api/v1/items/{itemId}" \
-X DELETE \
-H "Authorization: Bearer <access_token>"

Finds and returns the collections (and tags) of an item. This endpoint does not return the user's favorites collection.

Facts

Rate limit

Tier 1 (1000 requests per minute)

Query Parameters

limit integer

The maximum number of resources to return for a request. The limit must be an integer between 1 and 100 (inclusive).

minimum = 1, maximum = 100, default = 10, default = 10
name string

The case-sensitive string used to search for a collection by name.
next string

The cursor to the next page of resources. Provide either the next or prev cursor, but not both.
prev string

The cursor to the previous page of resources. Provide either the next or prev cursor, but not both.
query string

The case-insensitive string used to search for a resource by name or description.
sort string

The property of a resource to sort on (default sort is +createdAt). The supported properties are createdAt, updatedAt, and name. A property must be prefixed by + or - to indicate ascending or descending sort order respectively.

Can be one of: "+createdAt""-createdAt""+name""-name""+updatedAt""-updatedAt"
type string

The case-sensitive string used to search for a collection by type.

Can be one of: "private""public""publicgoverned"

Path Parameters

itemId string

Required

The item's unique identifier.

Responses

200

OK response.

application/json object

ListItemCollectionsResponseBody result type
Show application/json properties
- data array of objects
  
  Required
  
  A collection.
  
  Show data properties
  
  id string
  
  Required
  
  The collection's unique identifier.
  
  full boolean
  
  States if a collection has reached its items limit or not
  
  meta object
  
  Collection metadata and computed fields.
  
  Show meta properties
  
  items object
  
  Multiple items.
  
  Show items properties
  
  data array of objects
  
  Required
  
  An item.
  
  Show data properties
  
  id string
  
  Required
  
  The item's unique identifier.
  
  meta object
  
  Required
  
  Item metadata and computed fields.
  
  Show meta properties
  
  tags array of objects
  
  Required
  
  An array of tags that the item is part of.
  
  Show tags properties
  
  id string
  
  Required
  
  The ID of the tag/collection.
  
  name string
  
  Required
  
  The name of the tag/collection.
  
  actions array of strings
  
  Required
  
  The actions that the user can perform on the item.
  
  collections array of objects
  
  Required
  
  An array of collections that the item is part of.
  
  Show collections properties
  
  id string
  
  Required
  
  The ID of the tag/collection.
  
  name string
  
  Required
  
  The name of the tag/collection.
  
  isFavorited boolean
  
  Required
  
  The flag that indicates if item is in the user's favorites collection.
  
  name string
  
  Required
  
  minLength = 1
  
  links object
  
  Required
  
  Show links properties
  
  open object
  
  Show open properties
  
  href string
  
  format = "uri"
  
  self object
  
  Show self properties
  
  href string
  
  format = "uri"
  
  qvPlugin object
  
  Show qvPlugin properties
  
  href string
  
  format = "uri"
  
  thumbnail object
  
  Show thumbnail properties
  
  href string
  
  format = "uri"
  
  collections object
  
  Show collections properties
  
  href string
  
  format = "uri"
  
  actions array of strings
  
  Required
  
  The actions that the user can perform on the item.
  
  ownerId string
  
  The ID of the user who owns the item.
  
  spaceId string
  
  The space's unique identifier.
  
  tenantId string
  
  Required
  
  The ID of the tenant that owns the item. This is populated using the JWT.
  
  createdAt string
  
  Required
  
  The RFC3339 datetime when the item was created.
  
  format = "date-time"
  
  creatorId string
  
  The ID of the user who created the item. This is only populated if the JWT contains a userId.
  
  itemViews object
  
  Show itemViews properties
  
  week array of objects
  
  Show week properties
  
  start string
  
  The RFC3339 datetime representing the start of the referenced week.
  
  format = "date-time"
  
  total integer
  
  Total number of views the resource got during the referenced week.
  
  unique integer
  
  Number of unique users who viewed the resource during the referenced week.
  
  total integer
  
  Total number of views the resource got during the last 28 days.
  
  trend number
  
  Trend in views over the last 4 weeks. The trend value is a float number representing a linear regression slope (the x-coefficient) calculated from the weekly unique users views in the preceding 4 weeks.
  
  unique integer
  
  Number of unique users who viewed the resource during the last 28 days.
  
  usedBy integer
  
  Number of apps this dataset is used in (datasets only).
  
  updatedAt string
  
  Required
  
  The RFC3339 datetime when the item was last updated.
  
  format = "date-time"
  
  updaterId string
  
  ID of the user who last updated the item. This is only populated if the JWT contains a userId.
  
  resourceId string
  
  The case-sensitive string used to search for an item by resourceId. If resourceId is provided, then resourceType must be provided. Provide either the resourceId or resourceLink, but not both.
  
  description string
  
  isFavorited boolean
  
  Required
  
  The flag that indicates if item is in the user's favorites collection.
  
  thumbnailId string
  
  The item thumbnail's unique identifier. This is optional for internal resources.
  
  resourceLink string
  
  The case-sensitive string used to search for an item by resourceLink. If resourceLink is provided, then resourceType must be provided. Provide either the resourceId or resourceLink, but not both.
  
  format = "uri"
  
  resourceSize object
  
  Show resourceSize properties
  
  appFile number
  
  Size of the app on disk in bytes.
  
  appMemory number
  
  Size of the app in memory in bytes.
  
  resourceType string
  
  Required
  
  The case-sensitive string defining the item's type.
  
  Can be one of: "app""qlikview""qvapp""genericlink""sharingservicetask""note""dataasset""dataset""automation""automl-experiment""automl-deployment""assistant""dataproduct""dataqualityrule""glossary""knowledgebase""script""semantictype""page"
  
  collectionIds array of strings
  
  Required
  
  The ID of the collections that the item has been added to.
  
  resourceSubType string
  
  Optional field defining the item's subtype, if any.
  
  resourceCreatedAt string
  
  Required
  
  The RFC3339 datetime when the resource that the item references was created.
  
  format = "date-time"
  
  resourceUpdatedAt string
  
  Required
  
  The RFC3339 datetime when the resource that the item references was last updated.
  
  format = "date-time"
  
  resourceAttributes object
  
  Required
  
  additionalProperties = true
  
  resourceReloadStatus string
  
  If the resource last reload was successful or not.
  
  resourceReloadEndTime string
  
  The RFC3339 datetime when the resource last reload ended.
  
  format = "date-time"
  
  resourceCustomAttributes object
  
  Required
  
  additionalProperties = true
  
  links object
  
  Required
  
  Show links properties
  
  next object
  
  Show next properties
  
  href string
  
  format = "uri"
  
  prev object
  
  Show prev properties
  
  href string
  
  format = "uri"
  
  self object
  
  Show self properties
  
  href string
  
  format = "uri"
  
  collection object
  
  Show collection properties
  
  href string
  
  format = "uri"
  
  name string
  
  Required
  
  minLength = 1
  
  type string
  
  Required
  
  Can be one of: "private""public""favorite""publicgoverned"
  
  links object
  
  Required
  
  Show links properties
  
  self object
  
  Show self properties
  
  href string
  
  format = "uri"
  
  items object
  
  Show items properties
  
  href string
  
  format = "uri"
  
  tenantId string
  
  Required
  
  The ID of the tenant that owns the collection. This property is populated by using JWT.
  
  createdAt string
  
  Required
  
  The RFC3339 datetime when the collection was created.
  
  format = "date-time"
  
  creatorId string
  
  The ID of the user who created the collection. This property is only populated if the JWT contains a userId.
  
  itemCount integer
  
  Required
  
  The number of items that have been added to the collection that the user has access to.
  
  format = int64
  
  updatedAt string
  
  Required
  
  The RFC3339 datetime when the collection was last updated.
  
  format = "date-time"
  
  updaterId string
  
  The ID of the user who last updated the collection. This property is only populated if the JWT contains a userId.
  
  description string
- links object
  
  Required
  
  Show links properties
  
  item object
  
  Show item properties
  
  href string
  
  format = "uri"
  
  next object
  
  Show next properties
  
  href string
  
  format = "uri"
  
  prev object
  
  Show prev properties
  
  href string
  
  format = "uri"
  
  self object
  
  Show self properties
  
  href string
  
  format = "uri"

400

Bad Request response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

401

Unauthorized response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

404

Not found response

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

500

Internal Server Error response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

GET /api/v1/items/{itemId}/collections

import { createQlikApi } from '@qlik/api'

const qlik = createQlikApi({
  hostConfig: {
    host: 'https://{tenant}.{region}.qlikcloud.com',
    apiKey: '<access-token>',
  },
})

await qlik.items.getItemCollections('string', {})

qlik item collections 'string'

curl "https://{tenant}.{region}.qlikcloud.com/api/v1/items/{itemId}/collections" \
-H "Authorization: Bearer <access_token>"

Example Response

{
  "data": [
    {
      "id": "string",
      "full": true,
      "meta": {
        "items": {
          "data": [
            {
              "id": "string",
              "meta": {
                "tags": [
                  {
                    "id": "string",
                    "name": "string"
                  }
                ],
                "actions": [
                  "string"
                ],
                "collections": [
                  {
                    "id": "string",
                    "name": "string"
                  }
                ],
                "isFavorited": true
              },
              "name": "string",
              "links": {
                "open": {
                  "href": "string"
                },
                "self": {
                  "href": "string"
                },
                "qvPlugin": {
                  "href": "string"
                },
                "thumbnail": {
                  "href": "string"
                },
                "collections": {
                  "href": "string"
                }
              },
              "actions": [
                "string"
              ],
              "ownerId": "string",
              "spaceId": "string",
              "tenantId": "string",
              "createdAt": "2018-10-30T07:06:22Z",
              "creatorId": "string",
              "itemViews": {
                "week": [
                  {
                    "start": "2018-10-30T07:06:22Z",
                    "total": 42,
                    "unique": 42
                  }
                ],
                "total": 42,
                "trend": -4.2,
                "unique": 42,
                "usedBy": 42
              },
              "updatedAt": "2018-10-30T07:06:22Z",
              "updaterId": "string",
              "resourceId": "string",
              "description": "string",
              "isFavorited": true,
              "thumbnailId": "string",
              "resourceLink": "string",
              "resourceSize": {
                "appFile": 42,
                "appMemory": 42
              },
              "resourceType": "app",
              "collectionIds": [
                "string"
              ],
              "resourceSubType": "string",
              "resourceCreatedAt": "2018-10-30T07:06:22Z",
              "resourceUpdatedAt": "2018-10-30T07:06:22Z",
              "resourceAttributes": {},
              "resourceReloadStatus": "string",
              "resourceReloadEndTime": "2018-10-30T07:06:22Z",
              "resourceCustomAttributes": {}
            }
          ],
          "links": {
            "next": {
              "href": "string"
            },
            "prev": {
              "href": "string"
            },
            "self": {
              "href": "string"
            },
            "collection": {
              "href": "string"
            }
          }
        }
      },
      "name": "string",
      "type": "private",
      "links": {
        "self": {
          "href": "string"
        },
        "items": {
          "href": "string"
        }
      },
      "tenantId": "string",
      "createdAt": "2018-10-30T07:06:22Z",
      "creatorId": "string",
      "itemCount": 42,
      "updatedAt": "2018-10-30T07:06:22Z",
      "updaterId": "string",
      "description": "string"
    }
  ],
  "links": {
    "item": {
      "href": "string"
    },
    "next": {
      "href": "string"
    },
    "prev": {
      "href": "string"
    },
    "self": {
      "href": "string"
    }
  }
}

Finds and returns the published items for a given item. This endpoint is particularly useful for finding the published copies of an app or a qvapp when you want to replace the content of a published copy with new information from the source item.

Facts

Rate limit

Tier 1 (1000 requests per minute)

Query Parameters

limit integer

The maximum number of resources to return for a request. The limit must be an integer between 1 and 100 (inclusive).

minimum = 1, maximum = 100, default = 10, default = 10
next string

The cursor to the next page of resources. Provide either the next or prev cursor, but not both.
prev string

The cursor to the previous page of resources. Provide either the next or prev cursor, but not both.
resourceType string

The case-sensitive string used to search for an item by resourceType.

Can be one of: "app""qlikview""qvapp""genericlink""sharingservicetask""note""dataasset""dataset""automation""automl-experiment""automl-deployment""assistant""dataproduct""dataqualityrule""glossary""knowledgebase""script""semantictype""page"
sort string

The property of a resource to sort on (default sort is +createdAt). The supported properties are createdAt, updatedAt, and name. A property must be prefixed by + or - to indicate ascending or descending sort order respectively.

Can be one of: "+createdAt""-createdAt""+name""-name""+updatedAt""-updatedAt"

Path Parameters

itemId string

Required

The item's unique identifier

Responses

200

OK response.

application/json object

ListItemCollectionsResponseBody result type
Show application/json properties
- data array of objects
  
  Required
  
  A collection.
  
  Show data properties
  
  id string
  
  Required
  
  The collection's unique identifier.
  
  full boolean
  
  States if a collection has reached its items limit or not
  
  meta object
  
  Collection metadata and computed fields.
  
  Show meta properties
  
  items object
  
  Multiple items.
  
  Show items properties
  
  data array of objects
  
  Required
  
  An item.
  
  Show data properties
  
  id string
  
  Required
  
  The item's unique identifier.
  
  meta object
  
  Required
  
  Item metadata and computed fields.
  
  Show meta properties
  
  tags array of objects
  
  Required
  
  An array of tags that the item is part of.
  
  Show tags properties
  
  id string
  
  Required
  
  The ID of the tag/collection.
  
  name string
  
  Required
  
  The name of the tag/collection.
  
  actions array of strings
  
  Required
  
  The actions that the user can perform on the item.
  
  collections array of objects
  
  Required
  
  An array of collections that the item is part of.
  
  Show collections properties
  
  id string
  
  Required
  
  The ID of the tag/collection.
  
  name string
  
  Required
  
  The name of the tag/collection.
  
  isFavorited boolean
  
  Required
  
  The flag that indicates if item is in the user's favorites collection.
  
  name string
  
  Required
  
  minLength = 1
  
  links object
  
  Required
  
  Show links properties
  
  open object
  
  Show open properties
  
  href string
  
  format = "uri"
  
  self object
  
  Show self properties
  
  href string
  
  format = "uri"
  
  qvPlugin object
  
  Show qvPlugin properties
  
  href string
  
  format = "uri"
  
  thumbnail object
  
  Show thumbnail properties
  
  href string
  
  format = "uri"
  
  collections object
  
  Show collections properties
  
  href string
  
  format = "uri"
  
  actions array of strings
  
  Required
  
  The actions that the user can perform on the item.
  
  ownerId string
  
  The ID of the user who owns the item.
  
  spaceId string
  
  The space's unique identifier.
  
  tenantId string
  
  Required
  
  The ID of the tenant that owns the item. This is populated using the JWT.
  
  createdAt string
  
  Required
  
  The RFC3339 datetime when the item was created.
  
  format = "date-time"
  
  creatorId string
  
  The ID of the user who created the item. This is only populated if the JWT contains a userId.
  
  itemViews object
  
  Show itemViews properties
  
  week array of objects
  
  Show week properties
  
  start string
  
  The RFC3339 datetime representing the start of the referenced week.
  
  format = "date-time"
  
  total integer
  
  Total number of views the resource got during the referenced week.
  
  unique integer
  
  Number of unique users who viewed the resource during the referenced week.
  
  total integer
  
  Total number of views the resource got during the last 28 days.
  
  trend number
  
  Trend in views over the last 4 weeks. The trend value is a float number representing a linear regression slope (the x-coefficient) calculated from the weekly unique users views in the preceding 4 weeks.
  
  unique integer
  
  Number of unique users who viewed the resource during the last 28 days.
  
  usedBy integer
  
  Number of apps this dataset is used in (datasets only).
  
  updatedAt string
  
  Required
  
  The RFC3339 datetime when the item was last updated.
  
  format = "date-time"
  
  updaterId string
  
  ID of the user who last updated the item. This is only populated if the JWT contains a userId.
  
  resourceId string
  
  The case-sensitive string used to search for an item by resourceId. If resourceId is provided, then resourceType must be provided. Provide either the resourceId or resourceLink, but not both.
  
  description string
  
  isFavorited boolean
  
  Required
  
  The flag that indicates if item is in the user's favorites collection.
  
  thumbnailId string
  
  The item thumbnail's unique identifier. This is optional for internal resources.
  
  resourceLink string
  
  The case-sensitive string used to search for an item by resourceLink. If resourceLink is provided, then resourceType must be provided. Provide either the resourceId or resourceLink, but not both.
  
  format = "uri"
  
  resourceSize object
  
  Show resourceSize properties
  
  appFile number
  
  Size of the app on disk in bytes.
  
  appMemory number
  
  Size of the app in memory in bytes.
  
  resourceType string
  
  Required
  
  The case-sensitive string defining the item's type.
  
  Can be one of: "app""qlikview""qvapp""genericlink""sharingservicetask""note""dataasset""dataset""automation""automl-experiment""automl-deployment""assistant""dataproduct""dataqualityrule""glossary""knowledgebase""script""semantictype""page"
  
  collectionIds array of strings
  
  Required
  
  The ID of the collections that the item has been added to.
  
  resourceSubType string
  
  Optional field defining the item's subtype, if any.
  
  resourceCreatedAt string
  
  Required
  
  The RFC3339 datetime when the resource that the item references was created.
  
  format = "date-time"
  
  resourceUpdatedAt string
  
  Required
  
  The RFC3339 datetime when the resource that the item references was last updated.
  
  format = "date-time"
  
  resourceAttributes object
  
  Required
  
  additionalProperties = true
  
  resourceReloadStatus string
  
  If the resource last reload was successful or not.
  
  resourceReloadEndTime string
  
  The RFC3339 datetime when the resource last reload ended.
  
  format = "date-time"
  
  resourceCustomAttributes object
  
  Required
  
  additionalProperties = true
  
  links object
  
  Required
  
  Show links properties
  
  next object
  
  Show next properties
  
  href string
  
  format = "uri"
  
  prev object
  
  Show prev properties
  
  href string
  
  format = "uri"
  
  self object
  
  Show self properties
  
  href string
  
  format = "uri"
  
  collection object
  
  Show collection properties
  
  href string
  
  format = "uri"
  
  name string
  
  Required
  
  minLength = 1
  
  type string
  
  Required
  
  Can be one of: "private""public""favorite""publicgoverned"
  
  links object
  
  Required
  
  Show links properties
  
  self object
  
  Show self properties
  
  href string
  
  format = "uri"
  
  items object
  
  Show items properties
  
  href string
  
  format = "uri"
  
  tenantId string
  
  Required
  
  The ID of the tenant that owns the collection. This property is populated by using JWT.
  
  createdAt string
  
  Required
  
  The RFC3339 datetime when the collection was created.
  
  format = "date-time"
  
  creatorId string
  
  The ID of the user who created the collection. This property is only populated if the JWT contains a userId.
  
  itemCount integer
  
  Required
  
  The number of items that have been added to the collection that the user has access to.
  
  format = int64
  
  updatedAt string
  
  Required
  
  The RFC3339 datetime when the collection was last updated.
  
  format = "date-time"
  
  updaterId string
  
  The ID of the user who last updated the collection. This property is only populated if the JWT contains a userId.
  
  description string
- links object
  
  Required
  
  Show links properties
  
  item object
  
  Show item properties
  
  href string
  
  format = "uri"
  
  next object
  
  Show next properties
  
  href string
  
  format = "uri"
  
  prev object
  
  Show prev properties
  
  href string
  
  format = "uri"
  
  self object
  
  Show self properties
  
  href string
  
  format = "uri"

400

Bad Request response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

401

Unauthorized response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

404

Not Found response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

500

Internal Server Error response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

GET /api/v1/items/{itemId}/publisheditems

import { createQlikApi } from '@qlik/api'

const qlik = createQlikApi({
  hostConfig: {
    host: 'https://{tenant}.{region}.qlikcloud.com',
    apiKey: '<access-token>',
  },
})

await qlik.items.getPublishedItems('string', {})

qlik item publisheditems 'string'

curl "https://{tenant}.{region}.qlikcloud.com/api/v1/items/{itemId}/publisheditems" \
-H "Authorization: Bearer <access_token>"

Example Response

{
  "data": [
    {
      "id": "string",
      "full": true,
      "meta": {
        "items": {
          "data": [
            {
              "id": "string",
              "meta": {
                "tags": [
                  {
                    "id": "string",
                    "name": "string"
                  }
                ],
                "actions": [
                  "string"
                ],
                "collections": [
                  {
                    "id": "string",
                    "name": "string"
                  }
                ],
                "isFavorited": true
              },
              "name": "string",
              "links": {
                "open": {
                  "href": "string"
                },
                "self": {
                  "href": "string"
                },
                "qvPlugin": {
                  "href": "string"
                },
                "thumbnail": {
                  "href": "string"
                },
                "collections": {
                  "href": "string"
                }
              },
              "actions": [
                "string"
              ],
              "ownerId": "string",
              "spaceId": "string",
              "tenantId": "string",
              "createdAt": "2018-10-30T07:06:22Z",
              "creatorId": "string",
              "itemViews": {
                "week": [
                  {
                    "start": "2018-10-30T07:06:22Z",
                    "total": 42,
                    "unique": 42
                  }
                ],
                "total": 42,
                "trend": -4.2,
                "unique": 42,
                "usedBy": 42
              },
              "updatedAt": "2018-10-30T07:06:22Z",
              "updaterId": "string",
              "resourceId": "string",
              "description": "string",
              "isFavorited": true,
              "thumbnailId": "string",
              "resourceLink": "string",
              "resourceSize": {
                "appFile": 42,
                "appMemory": 42
              },
              "resourceType": "app",
              "collectionIds": [
                "string"
              ],
              "resourceSubType": "string",
              "resourceCreatedAt": "2018-10-30T07:06:22Z",
              "resourceUpdatedAt": "2018-10-30T07:06:22Z",
              "resourceAttributes": {},
              "resourceReloadStatus": "string",
              "resourceReloadEndTime": "2018-10-30T07:06:22Z",
              "resourceCustomAttributes": {}
            }
          ],
          "links": {
            "next": {
              "href": "string"
            },
            "prev": {
              "href": "string"
            },
            "self": {
              "href": "string"
            },
            "collection": {
              "href": "string"
            }
          }
        }
      },
      "name": "string",
      "type": "private",
      "links": {
        "self": {
          "href": "string"
        },
        "items": {
          "href": "string"
        }
      },
      "tenantId": "string",
      "createdAt": "2018-10-30T07:06:22Z",
      "creatorId": "string",
      "itemCount": 42,
      "updatedAt": "2018-10-30T07:06:22Z",
      "updaterId": "string",
      "description": "string"
    }
  ],
  "links": {
    "item": {
      "href": "string"
    },
    "next": {
      "href": "string"
    },
    "prev": {
      "href": "string"
    },
    "self": {
      "href": "string"
    }
  }
}

Finds and returns the items service settings for the current tenant. Currently used to enable or disable usage metrics in the tenant.

Facts

Rate limit

Tier 1 (1000 requests per minute)

Responses

200

OK response.

application/json object
Show application/json properties
- usageMetricsEnabled boolean
  
  Required
  
  Decides if the usage metrics will be shown in the hub UI.
  
  default = true

400

Bad Request response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

401

Unauthorized response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

500

Internal Server Error response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

GET /api/v1/items/settings

import { createQlikApi } from '@qlik/api'

const qlik = createQlikApi({
  hostConfig: {
    host: 'https://{tenant}.{region}.qlikcloud.com',
    apiKey: '<access-token>',
  },
})

await qlik.items.getItemsSettings()

qlik item settings ls

curl "https://{tenant}.{region}.qlikcloud.com/api/v1/items/settings" \
-H "Authorization: Bearer <access_token>"

Example Response

{
  "usageMetricsEnabled": true
}

Updates the settings provided in the patch body. Currently used to enable or disable usage metrics in the tenant.

Facts

Rate limit

Tier 2 (100 requests per minute)

Request Body

Required

application/json array of objects

A JSONPatch document as defined by RFC 6902.
Show application/json properties
- op string
  
  Required
  
  The operation to be performed. Only "replace" is supported.
  
  Can be one of: "replace"
- path string
  
  Required
  
  Field of Settings to be patched (updated).
  
  Can be one of: "/usageMetricsEnabled"
- value boolean
  
  Required
  
  The value to be used within the operations.

Responses

200

OK response.

application/json object
Show application/json properties
- usageMetricsEnabled boolean
  
  Required
  
  Decides if the usage metrics will be shown in the hub UI.
  
  default = true

400

Bad Request response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

401

Unauthorized response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

403

Forbidden response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

500

Internal Server Error response.

application/json object
Show application/json properties
- errors array of objects
  
  Show errors properties
  
  code string
  
  Code is a unique identifier for this error class.
  
  meta object
  
  Show meta properties
  
  fault boolean
  
  Is the error a server-side fault?
  
  explain object
  
  Further explanation of the error
  
  timeout boolean
  
  Is the error a timeout?
  
  temporary boolean
  
  Is the error temporary?
  
  title string
  
  Title is the name of this class of errors.
  
  detail string
  
  Detail is a human-readable explanation specific to this occurrence of the problem.

PATCH /api/v1/items/settings

import { createQlikApi } from '@qlik/api'

const qlik = createQlikApi({
  hostConfig: {
    host: 'https://{tenant}.{region}.qlikcloud.com',
    apiKey: '<access-token>',
  },
})

await qlik.items.patchItemsSettings([
  {
    op: 'replace',
    path: '/usageMetricsEnabled',
    value: true,
  },
])

qlik item settings patch \
  --op 'replace' \
  --path '/usageMetricsEnabled' \
  --value true

curl "https://{tenant}.{region}.qlikcloud.com/api/v1/items/settings" \
-X PATCH \
-H "Content-type: application/json" \
-H "Authorization: Bearer <access_token>" \
-d '[{"op":"replace","path":"/usageMetricsEnabled","value":true}]'

Example Response

{
  "usageMetricsEnabled": true
}

Items

Endpoints

List items

Facts

Query Parameters

Responses

200

400

401

404

500

Example Response

Get an item

Facts

Path Parameters

Responses

200

400

401

404

500

Example Response

Update an item

Facts

Path Parameters

Request Body

Responses

200

400

401

403

404

409

500

Example Response

Delete an item

Facts

Path Parameters

Responses

204

401

403

404

500

List collections of an item

Facts

Query Parameters

Path Parameters

Responses

200

400

401

404

500

Example Response

List published items

Facts

Query Parameters

Path Parameters

Responses

200

400

401

404

500

Example Response

Get items settings

Facts

Responses

200

400

401

500

Example Response

Update items settings

Facts

Request Body

Responses

200

400