Themes

Themes enable you to customize/style the Qlik Sense client experience.

Endpoints

Skip to section
GET/themes
POST/themes
GET/themes/{id}
PATCH/themes/{id}
DELETE/themes/{id}
GET/themes/{id}/file
GET/themes/{id}/file/{filepath}

Lists all themes.

Responses GET /themes

200
application/json

OK. Lists all themes.

GET/themes

curl "https://your-tenant.us.qlikcloud.com/api/v1/themes" \
 -H "Authorization: Bearer <API-key>"

Response GET /themes

{
  "data": [
    {
      "id": "string",
      "tenantId": "string",
      "userId": "string",
      "type": "string",
      "name": "string",
      "qextFilename": "string",
      "qextVersion": "string",
      "description": "string",
      "version": "string",
      "author": "string",
      "supplier": "string",
      "homepage": "string",
      "keywords": "string",
      "license": "string",
      "repository": "string",
      "dependencies": {},
      "icon": "string",
      "tags": [],
      "file": {},
      "createdAt": "2021-06-18T08:27:36.481Z",
      "updateAt": "2021-06-18T08:27:36.481Z"
    }
  ]
}

Creates a new theme. If a file is provided, the data field is not required.

Request Body POST /themes

data
multipart/form-data

The theme model.

file
multipart/form-data
string<binary>

Theme archive.

Responses POST /themes

201
application/json

Created. Creates a new theme and returns it.

409
application/json

Conflict. Resource with same unique identity already exists.

415
application/json

Unsupported media type. Body of the payload is not a valid JSON object.

422
application/json

Unprocessable entity. Validation error.

default
application/json

Unexpected error.

POST/themes

curl "https://your-tenant.us.qlikcloud.com/api/v1/themes" \
 -X POST \
 -H "Authorization: Bearer <API-key>" \
 -H "Content-type: multipart/form-data" \
 -F "file=@/path/to/file" \
 -d '{"id":"string","tenantId":"string","userId":"string","type":"string","name":"string","qextFilename":"string","qextVersion":"string","description":"string","version":"string","author":"string","supplier":"string","homepage":"string","keywords":"string","license":"string","repository":"string","dependencies":{},"icon":"string","tags":[],"file":{},"createdAt":"2021-06-18T08:27:36.481Z","updateAt":"2021-06-18T08:27:36.481Z"}'

Request POST /themes

{
  "id": "string",
  "tenantId": "string",
  "userId": "string",
  "type": "string",
  "name": "string",
  "qextFilename": "string",
  "qextVersion": "string",
  "description": "string",
  "version": "string",
  "author": "string",
  "supplier": "string",
  "homepage": "string",
  "keywords": "string",
  "license": "string",
  "repository": "string",
  "dependencies": {},
  "icon": "string",
  "tags": [],
  "file": {},
  "createdAt": "2021-06-18T08:27:36.481Z",
  "updateAt": "2021-06-18T08:27:36.481Z"
}

Response POST /themes

{
  "id": "string",
  "tenantId": "string",
  "userId": "string",
  "type": "string",
  "name": "string",
  "qextFilename": "string",
  "qextVersion": "string",
  "description": "string",
  "version": "string",
  "author": "string",
  "supplier": "string",
  "homepage": "string",
  "keywords": "string",
  "license": "string",
  "repository": "string",
  "dependencies": {},
  "icon": "string",
  "tags": [],
  "file": {},
  "createdAt": "2021-06-18T08:27:36.481Z",
  "updateAt": "2021-06-18T08:27:36.481Z"
}

Returns a specific theme.

Path Parameters GET /themes/{id}

id
string

Theme identifier or its qextFilename

Responses GET /themes/{id}

200
application/json

OK. Returns theme with {id}.

403
application/json

Forbidden. User is not authorized to read theme with {id}.

404
application/json

Not found. Could not find the theme with {id}.

410
application/json

Gone. Theme with {id} has been deleted.

GET/themes/{id}

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

Response GET /themes/{id}

{
  "id": "string",
  "tenantId": "string",
  "userId": "string",
  "type": "string",
  "name": "string",
  "qextFilename": "string",
  "qextVersion": "string",
  "description": "string",
  "version": "string",
  "author": "string",
  "supplier": "string",
  "homepage": "string",
  "keywords": "string",
  "license": "string",
  "repository": "string",
  "dependencies": {},
  "icon": "string",
  "tags": [],
  "file": {},
  "createdAt": "2021-06-18T08:27:36.483Z",
  "updateAt": "2021-06-18T08:27:36.483Z"
}

Updates a specific theme with provided data. If a file is provided, the data field is not required.

Path Parameters PATCH /themes/{id}

id
string

Theme identifier or its qextFilename.

Request Body PATCH /themes/{id}

data
multipart/form-data

The theme model.

file
multipart/form-data
string<binary>

Theme archive.

Responses PATCH /themes/{id}

200
application/json

OK. Theme has been updated.

403
application/json

Forbidden. User is not authorized to update theme with {id}.

404
application/json

Not found. Could not find the theme with {id}.

409
application/json

Conflict. Resource with same unique identity already exists.

415
application/json

Unsupported media type. Body of the payload is not a valid JSON object.

422
application/json

Unprocessable entity. Validation error.

default
application/json

Unexpected error.

PATCH/themes/{id}

curl "https://your-tenant.us.qlikcloud.com/api/v1/themes/{id}" \
 -X PATCH \
 -H "Authorization: Bearer <API-key>" \
 -H "Content-type: multipart/form-data" \
 -F "file=@/path/to/file" \
 -d '{"id":"string","tenantId":"string","userId":"string","type":"string","name":"string","qextFilename":"string","qextVersion":"string","description":"string","version":"string","author":"string","supplier":"string","homepage":"string","keywords":"string","license":"string","repository":"string","dependencies":{},"icon":"string","tags":[],"file":{},"createdAt":"2021-06-18T08:27:36.483Z","updateAt":"2021-06-18T08:27:36.483Z"}'

Request PATCH /themes/{id}

{
  "id": "string",
  "tenantId": "string",
  "userId": "string",
  "type": "string",
  "name": "string",
  "qextFilename": "string",
  "qextVersion": "string",
  "description": "string",
  "version": "string",
  "author": "string",
  "supplier": "string",
  "homepage": "string",
  "keywords": "string",
  "license": "string",
  "repository": "string",
  "dependencies": {},
  "icon": "string",
  "tags": [],
  "file": {},
  "createdAt": "2021-06-18T08:27:36.483Z",
  "updateAt": "2021-06-18T08:27:36.483Z"
}

Response PATCH /themes/{id}

{
  "data": [
    {
      "id": "string",
      "tenantId": "string",
      "userId": "string",
      "type": "string",
      "name": "string",
      "qextFilename": "string",
      "qextVersion": "string",
      "description": "string",
      "version": "string",
      "author": "string",
      "supplier": "string",
      "homepage": "string",
      "keywords": "string",
      "license": "string",
      "repository": "string",
      "dependencies": {},
      "icon": "string",
      "tags": [],
      "file": {},
      "createdAt": "2021-06-18T08:27:36.483Z",
      "updateAt": "2021-06-18T08:27:36.483Z"
    }
  ]
}

Deletes a specific theme.

Path Parameters DELETE /themes/{id}

id
string

Theme identifier or its qextFilename.

Responses DELETE /themes/{id}

204
object

No content. Soft deletes the theme.

403
application/json

Forbidden. User is not authorized to delete themes with {id}.

404
application/json

Not found. Could not find the theme with {id}.

410
application/json

Gone. Theme with {id} has been deleted.

DELETE/themes/{id}

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

Downloads the theme as an archive.

Path Parameters GET /themes/{id}/file

id
string

Theme identifier or its qextFilename

Responses GET /themes/{id}/file

200
object

OK. Theme exists. Returns the theme archive.

403
application/json

Forbidden. User is not authorized to read theme with {id}.

404
application/json

Not found. Could not find the theme with {id}.

410
application/json

Gone. Theme with {id} has been deleted.

GET/themes/{id}/file

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

Downloads a file from the theme archive.

Path Parameters GET /themes/{id}/file/{filepath}

id
string

Theme identifier or its qextFilename.

filepath
string

Path to the file archive for the specified theme archive. Folders separated with forward slashes.

Responses GET /themes/{id}/file/{filepath}

200
object

OK. Theme exists and the file specified exists. Returns the specific file.

403
application/json

Forbidden. User is not authorized to read theme with {id}.

404
application/json

Not found. Could not find a theme with {id} or the file does not exist in the archive.

410
application/json

Gone. Theme with {id} has been deleted.

GET/themes/{id}/file/{filepath}

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

extensions

object

Properties

data

No description

extension

object

The extension model.

Properties

id
string

No description

tenantId
string

No description

userId
string

No description

type
string

The type of this extension (visualization, etc.).

name
string

The display name of this extension.

qextFilename
string

The name of the qext file that was uploaded with this extension.

qextVersion
string

The version from the qext file that was uploaded with this extension.

description
string

Description of the extension.

version
string

Version of the extension.

author
string

Author of the extension.

supplier
string

Supplier of the extension.

homepage
string

Home page of the extension.

keywords
string

Keywords for the extension.

license
string

Under which license this extension is published.

repository
string

Link to the extension source code.

dependencies
object

Map of dependencies describing version of the component it requires.

icon
string

Icon to show in the client.

tags
Array<string>

List of tags.

preview
string

Path to an image that enables users to preview the extension.

checksum
string

Checksum of the extension contents.

bundled
boolean

If the extension is part of an extension bundle.

deprecated
string<date>

A date noting when the extension was deprecated.

bundle

Object containing meta data regarding the bundle the extension belongs to. If it does not belong to a bundle, this object is not defined.

supernova
boolean

If the extension is a supernova extension or not.

file
object

The file that was uploaded with the extension.

createdAt
string<date>

No description

updateAt
string<date>

No description

themes

object

Properties

data

No description

theme

object

The theme model.

Properties

id
string

No description

tenantId
string

No description

userId
string

No description

type
string

The type of this theme (visualization, etc.).

name
string

The display name of this theme.

qextFilename
string

The name of the qext file that was uploaded with this theme.

qextVersion
string

The version from the qext file that was uploaded with this extension.

description
string

Description of the theme.

version
string

Version of the theme.

author
string

Author of the theme.

supplier
string

Supplier of the theme.

homepage
string

Home page of the theme.

keywords
string

Keywords for the theme.

license
string

Under which license this theme is published.

repository
string

Link to the theme source code.

dependencies
object

Map of dependencies describing version of the component it requires.

icon
string

Icon to show in the client.

tags
Array<string>

List of tags.

file
object

The file that was uploaded with the theme.

createdAt
string<date>

No description

updateAt
string<date>

No description

error

An error object.

Properties

status
optional
number

The HTTP status code.

title
string

Title of the HTTP status code.

meta
optional

Object containing meta data regarding an error. It does not necessarily contain all the properties.

source
optional
object

Optional JSON patch object pointing to an invalid property.

meta

Object containing meta data regarding an error. It does not necessarily contain all the properties.

Properties

resourceName
string

Name of the resource related to the error. If there is a conflict, it is the name of the model attempting to be created.

message
string

A more detailed message explaining the error.

stack
string

Full stack trace of the error that was raised.

bundleMeta

Object containing meta data regarding the bundle the extension belongs to. If it does not belong to a bundle, this object is not defined.

Properties

id
string

Unique identifier of the bundle.

name
string

Name of the bundle.

description
string

Description of the bundle.

v4.0.2
Was this page helpful?