licenses

Licenses is the resource representing tenant and user entitlements

Endpoints
POST
/licenses/assignments/actions/add
POST
/licenses/assignments/actions/delete
POST
/licenses/assignments/actions/update
GET
/licenses/status
GET
/licenses/overview

assign access to users

experimental

Header Parameters

authorization
string<bearer>

authentication token

Request Body

list of subjects to allocate assignments for

Responses

207

processed (the status of the individual assignments are found in the response body)

400
application/json

body is bad or missing

401
application/json

unauthorized (invalid token)

POST
/licenses/assignments/actions/add
curl "https://your-tenant.us.qlikcloud.com/api/v1/licenses/assignments/actions/add" \
 -X POST \
 -H "Authorization: Bearer <API-key>" \
 -H "Content-type: application/json" \
 -d '{"add":[{"subject":"qlik\\kalle","type":"professional"},{"subject":"qlik\\nalle","type":"analyzer"}]}'

Request

{
  "add": [
    {
      "subject": "qlik\\kalle",
      "type": "professional"
    },
    {
      "subject": "qlik\\nalle",
      "type": "analyzer"
    }
  ]
}

Response

{
  "data": [
    {
      "subject": "string",
      "type": "string",
      "status": 0,
      "code": "string",
      "title": "string"
    }
  ]
}

delete user license assignments

experimental

Header Parameters

authorization
string<bearer>

authentication token

Request Body

list of assignments to delete

Responses

207

processed (the status of the individual assignments are found in the response body)

400
application/json

body is bad or missing

401
application/json

unauthorized (invalid token)

POST
/licenses/assignments/actions/delete
curl "https://your-tenant.us.qlikcloud.com/api/v1/licenses/assignments/actions/delete" \
 -X POST \
 -H "Authorization: Bearer <API-key>" \
 -H "Content-type: application/json" \
 -d '{"delete":[{"subject":"qlik\\malik","type":"analyzer"}]}'

Request

{
  "delete": [
    {
      "subject": "qlik\\malik",
      "type": "analyzer"
    }
  ]
}

Response

{
  "data": [
    {
      "subject": "string",
      "type": "string",
      "status": 0,
      "code": "string",
      "title": "string"
    }
  ]
}

update user license assignments

experimental

Header Parameters

authorization
string<bearer>

authentication token

Request Body

list of assignments to update

Responses

207

processed (the status of the individual assignments are found in the response body)

400
application/json

body is bad or missing

401
application/json

unauthorized (invalid token)

POST
/licenses/assignments/actions/update
curl "https://your-tenant.us.qlikcloud.com/api/v1/licenses/assignments/actions/update" \
 -X POST \
 -H "Authorization: Bearer <API-key>" \
 -H "Content-type: application/json" \
 -d '{"update":[{"subject":"qlik\\malik","type":"professional","sourceType":"analyzer"}]}'

Request

{
  "update": [
    {
      "subject": "qlik\\malik",
      "type": "professional",
      "sourceType": "analyzer"
    }
  ]
}

Response

{
  "data": [
    {
      "subject": "string",
      "type": "string",
      "sourceType": "string",
      "status": 0,
      "code": "string",
      "title": "string"
    }
  ]
}

get license status

Header Parameters

authorization
string<bearer>

authentication token

Responses

200
application/json

licenses status info

400
application/json

invalid tenant

401
application/json

unauthorized (invalid token)

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

Response

{
  "status": "Ok",
  "valid": "string",
  "type": "Signed",
  "origin": "Internal",
  "trial": true,
  "product": "string"
}

get license overview

Header Parameters

authorization
string<bearer>

authentication token

Responses

200
application/json

licenses overview info

400
application/json

invalid tenant

401
application/json

unauthorized (invalid token)

404
application/json

license not found

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

Response

{
  "licenseNumber": "string",
  "licenseKey": "string",
  "valid": "string",
  "status": "Ok",
  "origin": "Internal",
  "trial": true,
  "allotments": [
    {
      "name": "professional",
      "usageClass": "string",
      "unitsUsed": 0,
      "units": 0,
      "overage": 0
    }
  ],
  "product": "string",
  "parameters": [
    {
      "name": "string",
      "valid": "string",
      "values": {},
      "access": {
        "allotment": "string"
      }
    }
  ]
}

errorResponse

object

Properties

errors

No description

error
deprecated
string

error type

message
deprecated
string

error message

verifyTenantsAllowedBody

object

Properties

number
string

license number

verifyTenantsAllowedResponse

object

Properties

available
boolean

shows if more tenants are allowed for the license

validateRequestBody

object

Properties

number
string

license number

key
string

signed license key

validateResultResponseBody

object

Properties

valid
boolean

validation result

reason
string

reason for validation failure

settingsBody

object

Properties

autoAssignProfessional
boolean

No description

autoAssignAnalyzer
boolean

No description

allotmentBody

object

Properties

component
string

No description

allotmentResponse

object

Properties

usage
string

No description

Enum:

time

assigned

allotmentId
string

No description

duration
optional
string<duration>
provision
optional
object

No description

limitsResponse

object

allotmentProvisionResponse

object

Properties

usage
string

No description

Enum:

unlimited

allotmentId
string

No description

duration
optional
string<duration>
provision
optional
object

No description

allotmentProvisionListResponse

Array<object>

Properties

allotmentId
string

No description

usage
string

No description

Enum:

unlimited

provision
object

No description

getAllotmentsResponse

Array<object>

Properties

allotmentId
string

No description

name
optional
string

No description

usage
string

No description

Enum:

time

assigned

duration
optional
string<duration>
provision
optional
object

No description

allotmentsPrioritizedBody

object

Properties

subject
string

No description

requests
Array<string>

No description

allotmentsProvisionBody

object

Properties

provision
string

No description

allotmentsProvisionListBody

object

Properties

provisions
Array<string>

No description

renewBody

Array<object>

Properties

allotmentId
string

No description

sessionCount
integer

No description

licensesResponse

object

Properties

id
string

No description

assignmentsPatchBody

Array<object>

Properties

id
optional
string

the id of the assignment

sourceType
optional
string

No description

subject
optional
string

No description

type
string

the assignment type

Enum:

analyzer

professional

assignmentBody

object

Properties

subject
string

user identifier

type
string

the assignment type

Enum:

analyzer

professional

assignmentResponse

object

Properties

id
string

the id of the assignment

assignmentsResponse

object

Properties

data

No description

links

No description

href

object

Properties

href
string

link

patchAssignmentsResponse

Array<object>

Properties

id
optional
string

No description

sourceType
optional
string

No description

subject
optional
string

No description

type
string

No description

status
optional
integer

No description

addAssignmentsListBody

Array<object>

Properties

subject
string

No description

type
string

No description

name
optional
string

human readable display name for the subject

userId
optional
string

deployment unique id for the subject

addAssignmentsListResponse

Array<object>

Properties

id
optional
string

No description

type
string

No description

subject
string

No description

status
integer

No description

deleteAssignmentsListBody

Array<object>

Properties

id
string

No description

type
string

No description

subject
string

No description

deleteAssignmentsListResponse

Array<object>

Properties

id
optional
string

No description

type
optional
string

No description

subject
optional
string

No description

status
integer

No description

getAssignmentsListResponse

object

Properties

assignments

No description

max
integer

No description

assignmentsActionsAddRequest

object

Properties

add

No description

assignmentsActionsAddResponse

object

Properties

data

No description

assignmentsActionsDeleteRequest

object

Properties

delete

No description

assignmentsActionsDeleteResponse

object

Properties

data

No description

assignmentsActionsUpdateRequest

object

Properties

update

No description

assignmentsActionsUpdateResponse

object

Properties

data

No description

licenseStatus

object

Properties

status
string

Enum with status of license. Only status Ok grants license access.

Enum:

Ok

Blacklisted

Expired

Missing

valid
string

Period that the license is currently set to be active. Represented as an ISO 8601 time interval with start and end.

type
string

Type of license key

Enum:

Signed

Plain

origin
string

Origin of license key

Enum:

Internal

External

trial
boolean

Boolean indicating if it is a trial license

product
string

The product the license is valid for

licenseOverview

object

Properties

licenseNumber
string

No description

licenseKey
string

No description

valid
string

Period that the license is currently set to be active. Represented as an ISO 8601 time interval with start and end.

status
string

Enum with status of license. Only status Ok grants license access.

Enum:

Ok

Blacklisted

Expired

origin
string

Origin of license key

Enum:

Internal

External

trial
boolean

Boolean indicating if it is a trial license

allotments

No description

product
string

The product the license is valid for

parameters

The license parameters

licenseSignedDefinitionRequestBody

object

Properties

definition
string

base64 encoded license definition

signature
string

base64 encoded signature of the definition

keyId
string

ID of the key used to create the signature

licenseDefinitionRequestBody

object

Properties

key
string

license key

licenseDefinition

object

Properties

licenseNumber
string

license serial number

valid
string

time interval for definition validity

blacklisted
string

license blacklist status

allotments

No description

features

No description

allotmentMeResponse

object

Properties

id
string

id of the allotment

allotmentName
string

Name of the allotment

duration
optional
string<duration>

allotments

object

Properties

name
string

allotment name

usage

No description

units

No description

provisions

No description

features

object

Properties

name
string

feature name

value
string

feature value

valid
string

time interval for feature validity

auditLogs

Array<object>

Properties

seqNo
integer

audit log sequence number

type
integer

audit log type

message
string

base64 encoded audit log message

signautre
optional
string

audit log message signature

createdDate
string

audit log created date

parametersPostRequest

object

Properties

name
string

No description

autoAssign
optional
boolean

whether to do auto assignment if applicable, defaults to false

select
optional

No description

parametersSelect

object

Properties

name
string

No description

autoAssign
optional
boolean

whether to do auto assignment if applicable, defaults to false

parametersPostResponse

object

Properties

parameterSets

No description

parameterSet

object

Properties

name
string

No description

values
optional
object

No description

v6.1.1