Machine Learning
The Machine Learning API allows you to generate profile insights to analyze datasets, create and manage machine learning experiments, deploy models, and run predictions.
Endpoints
Facts
| Rate limit | Tier 1 (1000 requests per minute) |
Query Parameters
- filter string
Deployment fields by which you can filter responses.
spaceIdID string (or empty string for personal space) - ID of space in which deployment(s) existmodelIdUUID string - By model IDcreatedByID stringownerIdID stringexperimentIdUUID string - ID of experiment in which model(s) existexperimentVersionIdUUID string - ID of experiment version in which model(s) existpredictionIdUUID string - ID of prediction which exists on deploymentpredictionEnabledboolean - Are predictions enabledexactNamestring - Deployments with exact name. Names may not be unique.nameContainsstring - Deployments where name includes this. Names may not be uniqueexperimentTypestring - Deployments that have models of the experiment type
- sort string
Field(s) by which to sort response
Can be one of: "createdAt""+createdAt""-createdAt""name""+name""-name""updatedAt""+updatedAt""-updatedAt"
- limit integer
Number of results per page. Default is 32.
- offset integer
Number of rows to skip before getting page[size]
Responses
200
OK
- application/json object
application/json properties
- data array of objectsRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "deployment"
- attributes objectRequired
A deployed model against which you can run predictions
attributes properties
- id stringRequired Filterable
ID of this entity
- name stringRequired Filterable
Name of this entity
- errors array of objects
JSON string with list of error objects
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- modelId stringRequired Filterable
ID of the model currently assigned to the default alias.
- ownerId stringRequired Filterable
ID of owner/user for this entity
- spaceId stringRequired Filterable
Space ID for this entity (empty string for personal space)
- createdAt stringRequired
Timestamp when this was created
- createdBy stringRequired Filterable
ID of the owner/user that created this entity.
- updatedAt stringRequired
Timestamp when this was updated
- deprecated booleanRequired
Whether this deployment is deprecated
- description stringRequired
Description of this entity
- errorMessage string
JSON string of error object
- deployedModelIds array of strings
IDs of all models deployed to the deployment
- enablePredictions booleanRequired Filterable
Whether to allow predictions
-
-
- meta object
Meta for FIND operations
meta properties
- count integerRequired
-
- links objectRequired
Resource links included in paginated responses
links properties
- last objectRequired
last properties
- href string
Link to the last set of responses from
limitminusoffsettolimit
-
- next objectRequired
next properties
- href string
Link to the next set of responses
-
- prev objectRequired
prev properties
- href string
Link to the previous set of responses
-
- self objectRequired
self properties
- href string
Link to the current set of responses
-
- first objectRequired
first properties
- href string
Link to the first set of responses from
offset0 to count `limit``
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.getMlDeployments({})qlik ml deployment lscurl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments" \-H "Authorization: Bearer <access_token>"Example Response
{ "data": [ { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "deployment", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "errors": "[{\"code\":\"AML-145\",\"title\":\"datasync dependent service error, service profile\",\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\",\"meta\":{\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\"}}]\n", "modelId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "ownerId": "string", "spaceId": "string", "createdAt": "string", "createdBy": "string", "updatedAt": "string", "deprecated": true, "description": "string", "errorMessage": "string", "deployedModelIds": [ "c35f4b70-3ce4-4a30-b62b-2aef16943bc4" ], "enablePredictions": true } } ], "meta": { "count": 42 }, "links": { "last": { "href": "string" }, "next": { "href": "string" }, "prev": { "href": "string" }, "self": { "href": "string" }, "first": { "href": "string" } }}Facts
| Rate limit | Tier 2 (100 requests per minute) |
Request Body
- application/json object
Input for creating a new deployment
application/json properties
- data object
data properties
- type string
Can be one of: "deployment"
- attributes object
attributes properties
- name stringRequired Filterable
Name of this entity
- modelId stringRequired Filterable
ID of the model
- spaceId stringRequired Filterable
Space ID for this entity (empty string for personal space)
- deprecated boolean
Whether this deployment is deprecated
- description string
Description of this entity
- enablePredictions boolean
Whether to allow real-time predictions
-
-
-
Responses
201
Created
- application/json object
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "deployment"
- attributes objectRequired
A deployed model against which you can run predictions
attributes properties
- id stringRequired Filterable
ID of this entity
- name stringRequired Filterable
Name of this entity
- errors array of objects
JSON string with list of error objects
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- modelId stringRequired Filterable
ID of the model currently assigned to the default alias.
- ownerId stringRequired Filterable
ID of owner/user for this entity
- spaceId stringRequired Filterable
Space ID for this entity (empty string for personal space)
- createdAt stringRequired
Timestamp when this was created
- createdBy stringRequired Filterable
ID of the owner/user that created this entity.
- updatedAt stringRequired
Timestamp when this was updated
- deprecated booleanRequired
Whether this deployment is deprecated
- description stringRequired
Description of this entity
- errorMessage string
JSON string of error object
- deployedModelIds array of strings
IDs of all models deployed to the deployment
- enablePredictions booleanRequired Filterable
Whether to allow predictions
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.createMlDeployment({ data: { attributes: { deprecated: true, description: 'string', enablePredictions: true, modelId: 'c35f4b70-3ce4-4a30-b62b-2aef16943bc4', name: 'string', spaceId: 'string', }, type: 'deployment', },})qlik ml deployment create \ --data-attributes-modelId 'c35f4b70-3ce4-4a30-b62b-2aef16943bc4' \ --data-attributes-name 'string' \ --data-attributes-spaceId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments" \-X POST \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '{"data":{"type":"deployment","attributes":{"name":"string","modelId":"c35f4b70-3ce4-4a30-b62b-2aef16943bc4","spaceId":"string","deprecated":true,"description":"string","enablePredictions":true}}}'Example Response
{ "data": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "deployment", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "errors": "[{\"code\":\"AML-145\",\"title\":\"datasync dependent service error, service profile\",\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\",\"meta\":{\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\"}}]\n", "modelId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "ownerId": "string", "spaceId": "string", "createdAt": "string", "createdBy": "string", "updatedAt": "string", "deprecated": true, "description": "string", "errorMessage": "string", "deployedModelIds": [ "c35f4b70-3ce4-4a30-b62b-2aef16943bc4" ], "enablePredictions": true } }}Facts
| Rate limit | Tier 1 (1000 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
Responses
200
OK
- application/json object
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "deployment"
- attributes objectRequired
A deployed model against which you can run predictions
attributes properties
- id stringRequired Filterable
ID of this entity
- name stringRequired Filterable
Name of this entity
- errors array of objects
JSON string with list of error objects
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- modelId stringRequired Filterable
ID of the model currently assigned to the default alias.
- ownerId stringRequired Filterable
ID of owner/user for this entity
- spaceId stringRequired Filterable
Space ID for this entity (empty string for personal space)
- createdAt stringRequired
Timestamp when this was created
- createdBy stringRequired Filterable
ID of the owner/user that created this entity.
- updatedAt stringRequired
Timestamp when this was updated
- deprecated booleanRequired
Whether this deployment is deprecated
- description stringRequired
Description of this entity
- errorMessage string
JSON string of error object
- deployedModelIds array of strings
IDs of all models deployed to the deployment
- enablePredictions booleanRequired Filterable
Whether to allow predictions
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.getMlDeployment('string')qlik ml deployment get 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}" \-H "Authorization: Bearer <access_token>"Example Response
{ "data": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "deployment", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "errors": "[{\"code\":\"AML-145\",\"title\":\"datasync dependent service error, service profile\",\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\",\"meta\":{\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\"}}]\n", "modelId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "ownerId": "string", "spaceId": "string", "createdAt": "string", "createdBy": "string", "updatedAt": "string", "deprecated": true, "description": "string", "errorMessage": "string", "deployedModelIds": [ "c35f4b70-3ce4-4a30-b62b-2aef16943bc4" ], "enablePredictions": true } }}Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
Request Body
- application/json array of objects
Values that can be patched.
application/json properties
- op stringRequired
All patch requests use the replace operation
Can be one of: "replace"
- path stringRequired
Path for the property you want to update
Can be one of: "/name""/description""/spaceId"
- value anyRequired
Use for fields that can be
anytype (string, number, etc.)
-
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.patchMlDeployment('string', [ { op: 'replace', path: '/name', value: 'New Name', },])qlik ml deployment patch 'string' \ --op 'replace' \ --path '/name' \ --value New Namecurl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}" \-X PATCH \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '[{"op":"replace","path":"/name","value":"New Name"}]'Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.deleteMlDeployment('string')qlik ml deployment rm 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}" \-X DELETE \-H "Authorization: Bearer <access_token>"Activates the deployed model on this deployment's default alias. The
response reports which model was targeted and whether its state
actually changed via the qlik-model-id and qlik-state-change
response headers. If the model was already active, the request still
succeeds but qlik-state-change is NO_CHANGE.
Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.activateModelsMlDeployment('string')qlik ml deployment activate-models 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/actions/activate-models" \-X POST \-H "Authorization: Bearer <access_token>"Deactivates the deployed model on this deployment's default alias.
The response reports which model was targeted and whether its state
actually changed via the qlik-model-id and qlik-state-change
response headers. If the model was already inactive, the request
still succeeds but qlik-state-change is NO_CHANGE.
Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.deactivateModelsMlDeployment( 'string',)qlik ml deployment deactivate-models 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/actions/deactivate-models" \-X POST \-H "Authorization: Bearer <access_token>"Retrieves a list of aliases based on filter parameters for a deployment.
Facts
| Rate limit | Tier 1 (1000 requests per minute) |
Query Parameters
- filter string
Alias fields by which you can filter responses
namestring - Aliases with exact namemodelIdUUID string - By model IDmodeenum string - Mode by which alias is set to
- sort string
Field(s) by which to sort response
Can be one of: "name""+name""-name"
- limit integer
Number of results per page. Default is 32.
- offset integer
Number of rows to skip before getting page[size]
Path Parameters
- deploymentId stringRequired
ID of the deployment
Responses
200
OK
- application/json object
application/json properties
- data array of objectsRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "alias"
- attributes objectRequired
An AutoML alias
attributes properties
- id stringRequired Filterable
ID of this entity
- mode stringRequired
The mode of an alias. Default mode means the model assigned to that alias will be used if alias is not specified
Can be one of: "default""undefined"
- name stringRequired Filterable
Name of this entity
- models array of objectsRequired
Model information stored on an alias
models properties
- id string
ID of this entity
-
- createdAt stringRequired
Timestamp when this was created
- createdBy stringRequired
ID of the owner/user that created this entity
- updatedAt stringRequired
Timestamp when this was updated
- deploymentId stringRequired Filterable
ID of a model deployment
-
-
- meta object
Meta for FIND operations
meta properties
- count integerRequired
-
- links objectRequired
Resource links included in paginated responses
links properties
- last objectRequired
last properties
- href string
Link to the last set of responses from
limitminusoffsettolimit
-
- next objectRequired
next properties
- href string
Link to the next set of responses
-
- prev objectRequired
prev properties
- href string
Link to the previous set of responses
-
- self objectRequired
self properties
- href string
Link to the current set of responses
-
- first objectRequired
first properties
- href string
Link to the first set of responses from
offset0 to count `limit``
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.getMlDeploymentAliases('string', {})qlik ml deployment alias ls \ --deploymentId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/aliases" \-H "Authorization: Bearer <access_token>"Example Response
{ "data": [ { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "alias", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "mode": "default", "name": "string", "models": [ { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4" } ], "createdAt": "string", "createdBy": "string", "updatedAt": "string", "deploymentId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4" } } ], "meta": { "count": 42 }, "links": { "last": { "href": "string" }, "next": { "href": "string" }, "prev": { "href": "string" }, "self": { "href": "string" }, "first": { "href": "string" } }}Creates an alias for a deployment.
Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
Request Body
- application/json object
Input for creating a new alias
application/json properties
- data objectRequired
data properties
- type stringRequired
Can be one of: "alias"
- attributes objectRequired
attributes properties
- name stringRequired Filterable
Name of this entity
- models array of objectsRequired
Model information stored on an alias
models properties
- id string
ID of this entity
-
-
-
-
Responses
201
Created
- application/json object
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "alias"
- attributes objectRequired
An AutoML alias
attributes properties
- id stringRequired Filterable
ID of this entity
- mode stringRequired
The mode of an alias. Default mode means the model assigned to that alias will be used if alias is not specified
Can be one of: "default""undefined"
- name stringRequired Filterable
Name of this entity
- models array of objectsRequired
Model information stored on an alias
models properties
- id string
ID of this entity
-
- createdAt stringRequired
Timestamp when this was created
- createdBy stringRequired
ID of the owner/user that created this entity
- updatedAt stringRequired
Timestamp when this was updated
- deploymentId stringRequired Filterable
ID of a model deployment
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.createMlDeploymentAliase('string', { data: { attributes: { models: [ { id: 'c35f4b70-3ce4-4a30-b62b-2aef16943bc4', }, ], name: 'string', }, type: 'alias', },})qlik ml deployment alias create \ --deploymentId 'string' \ --data-attributes-models-id '' \ --data-attributes-name 'string' \ --data-type 'alias'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/aliases" \-X POST \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '{"data":{"type":"alias","attributes":{"name":"string","models":[{"id":"c35f4b70-3ce4-4a30-b62b-2aef16943bc4"}]}}}'Example Response
{ "data": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "alias", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "mode": "default", "name": "string", "models": [ { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4" } ], "createdAt": "string", "createdBy": "string", "updatedAt": "string", "deploymentId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4" } }}Retrieves an alias that exists on the deployment.
Facts
| Rate limit | Tier 1 (1000 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
- aliasId stringRequired
ID of the alias
Responses
200
OK
- application/json object
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "alias"
- attributes objectRequired
An AutoML alias
attributes properties
- id stringRequired Filterable
ID of this entity
- mode stringRequired
The mode of an alias. Default mode means the model assigned to that alias will be used if alias is not specified
Can be one of: "default""undefined"
- name stringRequired Filterable
Name of this entity
- models array of objectsRequired
Model information stored on an alias
models properties
- id string
ID of this entity
-
- createdAt stringRequired
Timestamp when this was created
- createdBy stringRequired
ID of the owner/user that created this entity
- updatedAt stringRequired
Timestamp when this was updated
- deploymentId stringRequired Filterable
ID of a model deployment
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.getMlDeploymentAliase( 'string', 'string',)qlik ml deployment alias get 'string' \ --deploymentId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/aliases/{aliasId}" \-H "Authorization: Bearer <access_token>"Example Response
{ "data": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "alias", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "mode": "default", "name": "string", "models": [ { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4" } ], "createdAt": "string", "createdBy": "string", "updatedAt": "string", "deploymentId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4" } }}Updates an alias for a deployment.
Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
- aliasId stringRequired
ID of the alias
Request Body
- application/json array of objects
Alias values that can be patched.
application/json properties
- op stringRequired
All patch requests use the replace operation
Can be one of: "replace"
- path stringRequired
Path for the property you want to update
Can be one of: "/name""/models"
- value anyRequired
Use for fields that can be
anytype (string, number, etc.)
-
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.patchMlDeploymentAliase( 'string', 'string', [ { op: 'replace', path: '/name', value: 'New Name', },
{ op: 'replace', path: '/models', value: 'modelId', }, ],)qlik ml deployment alias patch 'string' \ --deploymentId 'string' \ --op 'replace' \ --path '/name' \ --value New Namecurl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/aliases/{aliasId}" \-X PATCH \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '[{"op":"replace","path":"/name","value":"New Name"},{"op":"replace","path":"/models","value":"modelId"}]'Delete an alias from a deployment.
Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
- aliasId stringRequired
ID of the alias
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.deleteMlDeploymentAliase( 'string', 'string',)qlik ml deployment alias rm 'string' \ --deploymentId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/aliases/{aliasId}" \-X DELETE \-H "Authorization: Bearer <access_token>"Facts
| Rate limit | Tier 2 (100 requests per minute) |
Query Parameters
- includeNotPredictedReason boolean
If true, reason why a prediction was not produced included response
- includeShap boolean
If true, shap values included in response
- includeSource boolean
If true, source data included in response
- index string
The name of the feature in the source data to use as an index in the response data. The column will be included with its original name and values. This is intended to allow the caller to join results with source data.
Path Parameters
- deploymentId stringRequired
ID of the deployment
- aliasName stringRequired
The name of the ML Deployment Alias that will be used to determine which model should be used to produce predictions
Request Body
Request payload containing the dataset for predictions. Date features must be in ISO 8601 format.
- application/json object
Input values for creating realtime predictions
application/json properties
- rows array of arrays
Rows of the dataset from which to produce predictions. Date features must be in ISO 8601 format.
- schema array of objects
List of features in the dataset.
schema properties
- name string
The name of a feature in the dataset
-
-
Responses
200
Stream of combined prediction output returned successfully.
- application/json object
Input values for creating realtime predictions
application/json properties
- data object
data properties
- type string
Can be one of: "realtime-prediction"
- attributes object
attributes properties
- rows array of arrays
Rows of the dataset from which to produce predictions
- schema array of objects
List of features in the dataset
schema properties
- name string
The name of a feature in the dataset
-
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
409
Conflict
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.runMlDeploymentAliaseRealtimePredictions( 'string', 'string', {}, { rows: [['string']], schema: [{ name: 'string' }], },)qlik ml deployment alias realtime-prediction \ --deploymentId 'string' \ --aliasName 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/aliases/{aliasName}/realtime-predictions/actions/run" \-X POST \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '{"rows":[["string"]],"schema":[{"name":"string"}]}'Example Response
{ "data": { "type": "realtime-prediction", "attributes": { "rows": [ [ "string" ] ], "schema": [ { "name": "string" } ] } }}Facts
| Rate limit | Tier 1 (1000 requests per minute) |
Query Parameters
- filter string
Batch prediction fields by which you can filter responses.
aliasIdUUID string - ID of an alias within the batch predictioncreatedByID stringdeploymentIdUUID string - ID of a deployment of a model associated with the experimentexperimentIdUUID string - ID of experiment in which model(s) existexperimentVersionIdUUID string - ID of experiment version in which model(s) existmodelIdUUID string - By model IDownerIdID string of batch prediction owner
- sort string
Field(s) by which to sort response
Can be one of: "createdAt""+createdAt""-createdAt""description""+description""-description""name""+name""-name""updatedAt""+updatedAt""-updatedAt"
- limit integer
Number of results per page. Default is 32.
- offset integer
Number of rows to skip before getting page[size]
Path Parameters
- deploymentId stringRequired
ID of the deployment
Responses
200
OK
- application/json object
application/json properties
- data array of objectsRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "batch-prediction"
- attributes objectRequired
A batch prediction job configuration
attributes properties
- id string
ID of this entity
- name string
Name of this entity
- errors array of objects
JSON string with list of error objects
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- status string
Status of this batch prediction
Can be one of: "modified""ready""error""cancelled""pending"
- aliasId string
ID of an alias
- ownerId string
ID of owner/user for this entity
- schedule object
Batch prediction job schedule
schedule properties
- status string
The status of the schedule
Can be one of: "pending""active""error""error_scheduler_unreachable""error_scheduler_callback_error""licence_advanced_features_required""failing_schedule_permission"
- timezone string
Timezone used for the date-time fields
- recurrence array of strings
Recurrence rules. Maximum is DAILY but you can specify the hour, minute, and second it runs each day. One string per rule.
- endDateTime string
When the job finished
- chronosJobId string
The ID of the chronos job
- startDateTime string
When the job is scheduled to start
- failureAttempts number
Number of times a scheduled prediction job has failed
- applyDatasetChangeOnly boolean
If true, only run prediction if dataset has changed to avoid duplicates. If set to false, re-runs predictions on unchanged datasets.
- lastSuccessfulDateTime string
When the last successful job happened
-
- createdAt string
Timestamp when this was created
- createdBy string
ID of the owner/user that ran this prediction batch
- dataSetId string
The Qlik catalog dataset ID
- datasetId string
ID of the dataset with the prediction results
- updatedAt string
Timestamp when this was updated
- writeback object
Sets which files, file names, and spaces are used to write results of batch predictions (output files) to the catalog.
Note that for predictions based on time series models,
dstShapNameanddstCoordShapNamedo not apply and will be ignored if set.writeback properties
- format stringRequired
File format for write back files (this applies to all)
Can be one of: "qvd""parquet""csv"
- dstName stringRequired
- spaceId stringRequired
Space ID where you want to save batch prediction writebacks or empty string ('') save them to your personal space.
- dstShapName string
- dstSourceName string
- dstCoordShapName string
- dstNotPredictedName string
-
- indexColumn string
A optional column name upon which to create an index. Must be unique for every row. If not included, Qlik will create a unique index column.
- deploymentId string
ID of a model deployment
- errorMessage string
JSON string of error object
- outputDataset string
Where to output dataset
-
-
- meta object
Meta for FIND operations
meta properties
- count integerRequired
-
- links objectRequired
Resource links included in paginated responses
links properties
- last objectRequired
last properties
- href string
Link to the last set of responses from
limitminusoffsettolimit
-
- next objectRequired
next properties
- href string
Link to the next set of responses
-
- prev objectRequired
prev properties
- href string
Link to the previous set of responses
-
- self objectRequired
self properties
- href string
Link to the current set of responses
-
- first objectRequired
first properties
- href string
Link to the first set of responses from
offset0 to count `limit``
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.getMlDeploymentBatchPredictions( 'string', {},)qlik ml deployment batch-prediction ls \ --deploymentId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/batch-predictions" \-H "Authorization: Bearer <access_token>"Example Response
{ "data": [ { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "batch-prediction", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "errors": "[{\"code\":\"AML-145\",\"title\":\"datasync dependent service error, service profile\",\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\",\"meta\":{\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\"}}]\n", "status": "modified", "aliasId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "ownerId": "string", "schedule": { "status": "pending", "timezone": "America/Toronto", "recurrence": [ [ "Daily at 11:10:00 AM [\"RRULE:FREQ=DAILY;BYHOUR=11;BYMINUTE=10;BYSECOND=0\"]", "Weekly on Mondays at 11:10:00 AM [\"RRULE:FREQ=WEEKLY;INTERVAL:1;BYDAY=MO;BYHOUR=11;BYMINUTE=10;BYSECOND=0\"]" ] ], "endDateTime": "string", "chronosJobId": "string", "startDateTime": "string", "failureAttempts": 42, "applyDatasetChangeOnly": true, "lastSuccessfulDateTime": "string" }, "createdAt": "string", "createdBy": "string", "dataSetId": "672e55cfcadfb8a18281523e", "datasetId": "string", "updatedAt": "string", "writeback": { "format": "parquet", "dstName": "string", "spaceId": "string", "dstShapName": "string", "dstSourceName": "string", "dstCoordShapName": "string", "dstNotPredictedName": "string" }, "indexColumn": "string", "deploymentId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "errorMessage": "string", "outputDataset": "string" } } ], "meta": { "count": 42 }, "links": { "last": { "href": "string" }, "next": { "href": "string" }, "prev": { "href": "string" }, "self": { "href": "string" }, "first": { "href": "string" } }}Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
Request Body
- application/json object
Input values for creating a batch prediction configuration
application/json properties
- data object
data properties
- type string
Can be one of: "batch-prediction"
- attributes object
attributes properties
- name string
Name of this entity
- aliasId string
ID of an alias
- schedule object
Configuration to schedule a batch prediction
schedule properties
- timezone stringRequired
Timezone used for the date-time fields
- recurrence array of stringsRequired
Recurrence rules. Maximum is DAILY but you can specify the hour, minute, and second it runs each day. One string per rule.
- endDateTime string
When the job is scheduled to finish, date needs to be now or in future
- startDateTime stringRequired
When the job is scheduled to start, date needs to be now or in future
- applyDatasetChangeOnly booleanRequired
If true, only run prediction if dataset has changed to avoid duplicates. If set to false, re-runs predictions on unchanged datasets.
-
- dataSetId string
The Qlik catalog dataset ID
- writeback object
Sets which files, file names, and spaces are used to write results of batch predictions (output files) to the catalog.
Note that for predictions based on time series models,
dstShapNameanddstCoordShapNamedo not apply and will be ignored if set.writeback properties
- format stringRequired
File format for write back files (this applies to all)
Can be one of: "qvd""parquet""csv"
- dstName stringRequired
- spaceId stringRequired
Space ID where you want to save batch prediction writebacks or empty string ('') save them to your personal space.
- dstShapName string
- dstSourceName string
- dstCoordShapName string
- dstNotPredictedName string
-
- description string
- indexColumn string
A optional column name upon which to create an index. Must be unique for every row. If not included, Qlik will create a unique index column.
- deploymentId string
ID of a model deployment
-
-
-
Responses
201
Created
- application/json object
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "batch-prediction"
- attributes objectRequired
A batch prediction job configuration
attributes properties
- id string
ID of this entity
- name string
Name of this entity
- errors array of objects
JSON string with list of error objects
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- status string
Status of this batch prediction
Can be one of: "modified""ready""error""cancelled""pending"
- aliasId string
ID of an alias
- ownerId string
ID of owner/user for this entity
- schedule object
Batch prediction job schedule
schedule properties
- status string
The status of the schedule
Can be one of: "pending""active""error""error_scheduler_unreachable""error_scheduler_callback_error""licence_advanced_features_required""failing_schedule_permission"
- timezone string
Timezone used for the date-time fields
- recurrence array of strings
Recurrence rules. Maximum is DAILY but you can specify the hour, minute, and second it runs each day. One string per rule.
- endDateTime string
When the job finished
- chronosJobId string
The ID of the chronos job
- startDateTime string
When the job is scheduled to start
- failureAttempts number
Number of times a scheduled prediction job has failed
- applyDatasetChangeOnly boolean
If true, only run prediction if dataset has changed to avoid duplicates. If set to false, re-runs predictions on unchanged datasets.
- lastSuccessfulDateTime string
When the last successful job happened
-
- createdAt string
Timestamp when this was created
- createdBy string
ID of the owner/user that ran this prediction batch
- dataSetId string
The Qlik catalog dataset ID
- datasetId string
ID of the dataset with the prediction results
- updatedAt string
Timestamp when this was updated
- writeback object
Sets which files, file names, and spaces are used to write results of batch predictions (output files) to the catalog.
Note that for predictions based on time series models,
dstShapNameanddstCoordShapNamedo not apply and will be ignored if set.writeback properties
- format stringRequired
File format for write back files (this applies to all)
Can be one of: "qvd""parquet""csv"
- dstName stringRequired
- spaceId stringRequired
Space ID where you want to save batch prediction writebacks or empty string ('') save them to your personal space.
- dstShapName string
- dstSourceName string
- dstCoordShapName string
- dstNotPredictedName string
-
- indexColumn string
A optional column name upon which to create an index. Must be unique for every row. If not included, Qlik will create a unique index column.
- deploymentId string
ID of a model deployment
- errorMessage string
JSON string of error object
- outputDataset string
Where to output dataset
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.createMlDeploymentBatchPrediction( 'string', { data: { attributes: { aliasId: 'c35f4b70-3ce4-4a30-b62b-2aef16943bc4', dataSetId: '672e55cfcadfb8a18281523e', deploymentId: 'c35f4b70-3ce4-4a30-b62b-2aef16943bc4', description: 'string', indexColumn: 'string', name: 'string', schedule: { applyDatasetChangeOnly: true, endDateTime: '2035-12-31T23:59:00', recurrence: [ 'RRULE:FREQ=DAILY;INTERVAL=1;BYHOUR=16;BYMINUTE=30;BYSECOND=0', ], startDateTime: '2035-12-25T00:00:00', timezone: 'America/Toronto', }, writeback: { dstCoordShapName: 'string', dstName: 'string', dstNotPredictedName: 'string', dstShapName: 'string', dstSourceName: 'string', format: 'parquet', spaceId: 'string', }, }, type: 'batch-prediction', }, },)qlik ml deployment batch-prediction create \ --deploymentId 'string' \ --data-attributes-schedule-startDateTime '2035-12-25T00:00:00' \ --data-attributes-schedule-timezone 'America/Toronto' \ --data-attributes-writeback-dstName 'string' \ --data-attributes-writeback-format 'parquet' \ --data-attributes-writeback-spaceId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/batch-predictions" \-X POST \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '{"data":{"type":"batch-prediction","attributes":{"name":"string","aliasId":"c35f4b70-3ce4-4a30-b62b-2aef16943bc4","schedule":{"timezone":"America/Toronto","recurrence":["RRULE:FREQ=DAILY;INTERVAL=1;BYHOUR=16;BYMINUTE=30;BYSECOND=0"],"endDateTime":"2035-12-31T23:59:00","startDateTime":"2035-12-25T00:00:00","applyDatasetChangeOnly":true},"dataSetId":"672e55cfcadfb8a18281523e","writeback":{"format":"parquet","dstName":"string","spaceId":"string","dstShapName":"string","dstSourceName":"string","dstCoordShapName":"string","dstNotPredictedName":"string"},"description":"string","indexColumn":"string","deploymentId":"c35f4b70-3ce4-4a30-b62b-2aef16943bc4"}}}'Example Response
{ "data": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "batch-prediction", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "errors": "[{\"code\":\"AML-145\",\"title\":\"datasync dependent service error, service profile\",\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\",\"meta\":{\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\"}}]\n", "status": "modified", "aliasId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "ownerId": "string", "schedule": { "status": "pending", "timezone": "America/Toronto", "recurrence": [ [ "Daily at 11:10:00 AM [\"RRULE:FREQ=DAILY;BYHOUR=11;BYMINUTE=10;BYSECOND=0\"]", "Weekly on Mondays at 11:10:00 AM [\"RRULE:FREQ=WEEKLY;INTERVAL:1;BYDAY=MO;BYHOUR=11;BYMINUTE=10;BYSECOND=0\"]" ] ], "endDateTime": "string", "chronosJobId": "string", "startDateTime": "string", "failureAttempts": 42, "applyDatasetChangeOnly": true, "lastSuccessfulDateTime": "string" }, "createdAt": "string", "createdBy": "string", "dataSetId": "672e55cfcadfb8a18281523e", "datasetId": "string", "updatedAt": "string", "writeback": { "format": "parquet", "dstName": "string", "spaceId": "string", "dstShapName": "string", "dstSourceName": "string", "dstCoordShapName": "string", "dstNotPredictedName": "string" }, "indexColumn": "string", "deploymentId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "errorMessage": "string", "outputDataset": "string" } }}Facts
| Rate limit | Tier 1 (1000 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
- batchPredictionId stringRequired
ID of the batch prediction
Responses
200
OK
- application/json object
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "batch-prediction"
- attributes objectRequired
A batch prediction job configuration
attributes properties
- id string
ID of this entity
- name string
Name of this entity
- errors array of objects
JSON string with list of error objects
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- status string
Status of this batch prediction
Can be one of: "modified""ready""error""cancelled""pending"
- aliasId string
ID of an alias
- ownerId string
ID of owner/user for this entity
- schedule object
Batch prediction job schedule
schedule properties
- status string
The status of the schedule
Can be one of: "pending""active""error""error_scheduler_unreachable""error_scheduler_callback_error""licence_advanced_features_required""failing_schedule_permission"
- timezone string
Timezone used for the date-time fields
- recurrence array of strings
Recurrence rules. Maximum is DAILY but you can specify the hour, minute, and second it runs each day. One string per rule.
- endDateTime string
When the job finished
- chronosJobId string
The ID of the chronos job
- startDateTime string
When the job is scheduled to start
- failureAttempts number
Number of times a scheduled prediction job has failed
- applyDatasetChangeOnly boolean
If true, only run prediction if dataset has changed to avoid duplicates. If set to false, re-runs predictions on unchanged datasets.
- lastSuccessfulDateTime string
When the last successful job happened
-
- createdAt string
Timestamp when this was created
- createdBy string
ID of the owner/user that ran this prediction batch
- dataSetId string
The Qlik catalog dataset ID
- datasetId string
ID of the dataset with the prediction results
- updatedAt string
Timestamp when this was updated
- writeback object
Sets which files, file names, and spaces are used to write results of batch predictions (output files) to the catalog.
Note that for predictions based on time series models,
dstShapNameanddstCoordShapNamedo not apply and will be ignored if set.writeback properties
- format stringRequired
File format for write back files (this applies to all)
Can be one of: "qvd""parquet""csv"
- dstName stringRequired
- spaceId stringRequired
Space ID where you want to save batch prediction writebacks or empty string ('') save them to your personal space.
- dstShapName string
- dstSourceName string
- dstCoordShapName string
- dstNotPredictedName string
-
- indexColumn string
A optional column name upon which to create an index. Must be unique for every row. If not included, Qlik will create a unique index column.
- deploymentId string
ID of a model deployment
- errorMessage string
JSON string of error object
- outputDataset string
Where to output dataset
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.getMlDeploymentBatchPrediction( 'string', 'string',)qlik ml deployment batch-prediction get 'string' \ --deploymentId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/batch-predictions/{batchPredictionId}" \-H "Authorization: Bearer <access_token>"Example Response
{ "data": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "batch-prediction", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "errors": "[{\"code\":\"AML-145\",\"title\":\"datasync dependent service error, service profile\",\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\",\"meta\":{\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\"}}]\n", "status": "modified", "aliasId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "ownerId": "string", "schedule": { "status": "pending", "timezone": "America/Toronto", "recurrence": [ [ "Daily at 11:10:00 AM [\"RRULE:FREQ=DAILY;BYHOUR=11;BYMINUTE=10;BYSECOND=0\"]", "Weekly on Mondays at 11:10:00 AM [\"RRULE:FREQ=WEEKLY;INTERVAL:1;BYDAY=MO;BYHOUR=11;BYMINUTE=10;BYSECOND=0\"]" ] ], "endDateTime": "string", "chronosJobId": "string", "startDateTime": "string", "failureAttempts": 42, "applyDatasetChangeOnly": true, "lastSuccessfulDateTime": "string" }, "createdAt": "string", "createdBy": "string", "dataSetId": "672e55cfcadfb8a18281523e", "datasetId": "string", "updatedAt": "string", "writeback": { "format": "parquet", "dstName": "string", "spaceId": "string", "dstShapName": "string", "dstSourceName": "string", "dstCoordShapName": "string", "dstNotPredictedName": "string" }, "indexColumn": "string", "deploymentId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "errorMessage": "string", "outputDataset": "string" } }}Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
- batchPredictionId stringRequired
ID of the batch prediction
Request Body
- application/json array of objects
Values that can be patched.
- name: Name of this entity
- description: Description of this entity
- dataSetId
- outputDataset
- indexColumn: Column name upon which to create an index (empty string or undefined will default to automl-generated index)
- applyDatasetChangeOnly
- ownerId: ID of batch owner/user
- writeback: Where to write prediction results
application/json properties
- op stringRequired
All patch requests use the replace operation
Can be one of: "replace"
- path stringRequired
Path for the property you want to update
Can be one of: "/name""/description""/dataSetId""/indexColumn""/applyDatasetChangeOnly""/ownerId""/writeback/spaceId""/writeback/format""/writeback/dstName""/writeback/dstShapName""/writeback/dstCoordShapName""/writeback/dstNotPredictedName""/writeback/dstSourceName"
- value anyRequired
Use for fields that can be
anytype (string, number, etc.)
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.patchMlDeploymentBatchPrediction( 'string', 'string', [ { op: 'replace', path: '/name', value: 'New Name', }, ],)qlik ml deployment batch-prediction patch 'string' \ --deploymentId 'string' \ --op 'replace' \ --path '/name' \ --value New Namecurl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/batch-predictions/{batchPredictionId}" \-X PATCH \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '[{"op":"replace","path":"/name","value":"New Name"}]'Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
- batchPredictionId stringRequired
ID of the batch prediction
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.deleteMlDeploymentBatchPrediction( 'string', 'string',)qlik ml deployment batch-prediction rm 'string' \ --deploymentId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/batch-predictions/{batchPredictionId}" \-X DELETE \-H "Authorization: Bearer <access_token>"Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
- batchPredictionId stringRequired
ID of the batch prediction
Responses
202
Accepted
- application/json object
Response for batch prediction predict action that indicates job and status
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "job"
- attributes objectRequired
attributes properties
- id stringRequired Filterable
ID of this entity
- name stringRequired
- corrId stringRequired
The ID of a correlated resource of corrType
- status stringRequired
Status of this job
Can be one of: "pending""completed""cancelled""error""deleted_resource"
- details objectRequired
details properties
- isScheduled booleanRequired
- outputFiles array of objectsRequired
outputFiles properties
- key stringRequired
- path stringRequired
- spaceId stringRequired Filterable
Space ID for this entity (empty string for personal space)
- fileName stringRequired
- fileType stringRequired
Dataset file type
-
- lineageSchemaUpdated boolean
-
- jobType stringRequired
The type for this job
Can be one of: "prediction"
- modelId stringRequired Filterable
ID of the model
- success booleanRequired
- trigger stringRequired
- corrType stringRequired
Types names of correlated resources (batch 'prediction' and experiment_version)
Can be one of: "batch-prediction""experiment-version"
- tenantId stringRequired Filterable
Tenant ID for this entity
- createdAt stringRequired
Timestamp when this was created
- createdBy stringRequired
ID of the owner/user that created this entity
- deletedAt stringRequired
Timestamp when this is deleted
- updatedAt stringRequired
Timestamp when this was updated
- parentName stringRequired
- parentJobId string
ID of the current job's parent
- deploymentId stringRequired Filterable
ID of a model deployment
- rowsPredicted number
- experimentVersionNumber string
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.predictMlDeploymentBatchPrediction( 'string', 'string',)qlik ml deployment batch-prediction predict \ --deploymentId 'string' \ --batch-predictionId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/batch-predictions/{batchPredictionId}/actions/predict" \-X POST \-H "Authorization: Bearer <access_token>"Example Response
{ "data": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "job", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "corrId": "string", "status": "pending", "details": { "isScheduled": true, "outputFiles": [ { "key": "string", "path": "string", "spaceId": "string", "fileName": "string", "fileType": "qvd, parquet, csv" } ], "lineageSchemaUpdated": true }, "jobType": "prediction", "modelId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "success": true, "trigger": "string", "corrType": "batch-prediction", "tenantId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "createdAt": "string", "createdBy": "string", "deletedAt": "string", "updatedAt": "string", "parentName": "string", "parentJobId": "string", "deploymentId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "rowsPredicted": 42, "experimentVersionNumber": "string" } }}Retrieves the schedule for a batch prediction.
Facts
| Rate limit | Tier 1 (1000 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
- batchPredictionId stringRequired
ID of the batch prediction
Responses
200
OK
- application/json object
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "batch-prediction-schedule"
- attributes objectRequired
Batch prediction job schedule
attributes properties
- status string
The status of the schedule
Can be one of: "pending""active""error""error_scheduler_unreachable""error_scheduler_callback_error""licence_advanced_features_required""failing_schedule_permission"
- timezone string
Timezone used for the date-time fields
- recurrence array of strings
Recurrence rules. Maximum is DAILY but you can specify the hour, minute, and second it runs each day. One string per rule.
- endDateTime string
When the job finished
- chronosJobId string
The ID of the chronos job
- startDateTime string
When the job is scheduled to start
- failureAttempts number
Number of times a scheduled prediction job has failed
- applyDatasetChangeOnly boolean
If true, only run prediction if dataset has changed to avoid duplicates. If set to false, re-runs predictions on unchanged datasets.
- lastSuccessfulDateTime string
When the last successful job happened
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.getMlDeploymentBatchPredictionSchedule( 'string', 'string',)qlik ml deployment batch-prediction schedule get \ --deploymentId 'string' \ --batch-predictionId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/batch-predictions/{batchPredictionId}/schedule" \-H "Authorization: Bearer <access_token>"Example Response
{ "data": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "batch-prediction-schedule", "attributes": { "status": "pending", "timezone": "America/Toronto", "recurrence": [ [ "Daily at 11:10:00 AM [\"RRULE:FREQ=DAILY;BYHOUR=11;BYMINUTE=10;BYSECOND=0\"]", "Weekly on Mondays at 11:10:00 AM [\"RRULE:FREQ=WEEKLY;INTERVAL:1;BYDAY=MO;BYHOUR=11;BYMINUTE=10;BYSECOND=0\"]" ] ], "endDateTime": "string", "chronosJobId": "string", "startDateTime": "string", "failureAttempts": 42, "applyDatasetChangeOnly": true, "lastSuccessfulDateTime": "string" } }}Updates the schedule for a batch prediction.
Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
- batchPredictionId stringRequired
ID of the batch prediction
Request Body
- application/json array of objects
Values that can be patched.
- startDateTime: When the batch starts, if scheduled
- endDateTime: When batch ends, if scheduled
- timezone: Timezone used for scheduling
- recurrence: Array of strings to indicate when this batch recurs
- applyDatasetChangeOnly: Only run prediction if dataset has changed?
application/json properties
- op stringRequired
All patch requests use the replace operation
Can be one of: "replace"
- path stringRequired
Path for the property you want to update
Can be one of: "/startDateTime""/endDateTime""/timezone""/recurrence""/applyDatasetChangeOnly"
- value anyRequired
Use for fields that can be
anytype (string, number, etc.)
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.updateMlDeploymentBatchPredictionSchedule( 'string', 'string', [ { op: 'replace', path: '/startDateTime', value: '2022-09-14T12:00:00', }, ],)qlik ml deployment batch-prediction schedule update \ --deploymentId 'string' \ --batch-predictionId 'string' \ --op 'replace' \ --path '/startDateTime' \ --value 2022-09-14T12:00:00curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/batch-predictions/{batchPredictionId}/schedule" \-X PATCH \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '[{"op":"replace","path":"/startDateTime","value":"2022-09-14T12:00:00"}]'Adds a schedule to a batch prediction.
Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
- batchPredictionId stringRequired
ID of the batch prediction
Request Body
- application/json object
Input values for a batch prediction schedule
application/json properties
- data object
data properties
- type string
Can be one of: "batch-prediction-schedule"
- attributes object
Configuration to schedule a batch prediction
attributes properties
- timezone stringRequired
Timezone used for the date-time fields
- recurrence array of stringsRequired
Recurrence rules. Maximum is DAILY but you can specify the hour, minute, and second it runs each day. One string per rule.
- endDateTime string
When the job is scheduled to finish, date needs to be now or in future
- startDateTime stringRequired
When the job is scheduled to start, date needs to be now or in future
- applyDatasetChangeOnly booleanRequired
If true, only run prediction if dataset has changed to avoid duplicates. If set to false, re-runs predictions on unchanged datasets.
-
-
-
Responses
201
Created
- application/json object
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "batch-prediction-schedule"
- attributes objectRequired
Batch prediction job schedule
attributes properties
- status string
The status of the schedule
Can be one of: "pending""active""error""error_scheduler_unreachable""error_scheduler_callback_error""licence_advanced_features_required""failing_schedule_permission"
- timezone string
Timezone used for the date-time fields
- recurrence array of strings
Recurrence rules. Maximum is DAILY but you can specify the hour, minute, and second it runs each day. One string per rule.
- endDateTime string
When the job finished
- chronosJobId string
The ID of the chronos job
- startDateTime string
When the job is scheduled to start
- failureAttempts number
Number of times a scheduled prediction job has failed
- applyDatasetChangeOnly boolean
If true, only run prediction if dataset has changed to avoid duplicates. If set to false, re-runs predictions on unchanged datasets.
- lastSuccessfulDateTime string
When the last successful job happened
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.setMlDeploymentBatchPredictionSchedule( 'string', 'string', { data: { attributes: { applyDatasetChangeOnly: true, endDateTime: '2035-12-31T23:59:00', recurrence: [ 'RRULE:FREQ=DAILY;INTERVAL=1;BYHOUR=16;BYMINUTE=30;BYSECOND=0', ], startDateTime: '2035-12-25T00:00:00', timezone: 'America/Toronto', }, type: 'batch-prediction-schedule', }, },)qlik ml deployment batch-prediction schedule set \ --deploymentId 'string' \ --batch-predictionId 'string' \ --data-attributes-startDateTime '2035-12-25T00:00:00' \ --data-attributes-timezone 'America/Toronto'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/batch-predictions/{batchPredictionId}/schedule" \-X PUT \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '{"data":{"type":"batch-prediction-schedule","attributes":{"timezone":"America/Toronto","recurrence":["RRULE:FREQ=DAILY;INTERVAL=1;BYHOUR=16;BYMINUTE=30;BYSECOND=0"],"endDateTime":"2035-12-31T23:59:00","startDateTime":"2035-12-25T00:00:00","applyDatasetChangeOnly":true}}}'Example Response
{ "data": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "batch-prediction-schedule", "attributes": { "status": "pending", "timezone": "America/Toronto", "recurrence": [ [ "Daily at 11:10:00 AM [\"RRULE:FREQ=DAILY;BYHOUR=11;BYMINUTE=10;BYSECOND=0\"]", "Weekly on Mondays at 11:10:00 AM [\"RRULE:FREQ=WEEKLY;INTERVAL:1;BYDAY=MO;BYHOUR=11;BYMINUTE=10;BYSECOND=0\"]" ] ], "endDateTime": "string", "chronosJobId": "string", "startDateTime": "string", "failureAttempts": 42, "applyDatasetChangeOnly": true, "lastSuccessfulDateTime": "string" } }}Deletes the schedule from a batch prediction.
Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
- batchPredictionId stringRequired
ID of the batch prediction
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.deleteMlDeploymentBatchPredictionSchedule( 'string', 'string',)qlik ml deployment batch-prediction schedule rm \ --deploymentId 'string' \ --batch-predictionId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/batch-predictions/{batchPredictionId}/schedule" \-X DELETE \-H "Authorization: Bearer <access_token>"Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
Request Body
- application/json object
Input values for adding deployed models to a deployment
application/json properties
- data objectRequired
data properties
- type stringRequired
Can be one of: "deployed-models"
- attributes objectRequired
attributes properties
- deployedModelIds array of stringsRequired
IDs of all models deployed to the deployment
-
-
-
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.addMlDeploymentModels('string', { data: { attributes: { deployedModelIds: [ 'c35f4b70-3ce4-4a30-b62b-2aef16943bc4', ], }, type: 'deployed-models', },})qlik ml deployment model add 'string' \ --data-attributes-deployedModelIds 'c35f4b70-3ce4-4a30-b62b-2aef16943bc4' \ --data-type 'deployed-models'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/models/actions/add" \-X POST \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '{"data":{"type":"deployed-models","attributes":{"deployedModelIds":["c35f4b70-3ce4-4a30-b62b-2aef16943bc4"]}}}'Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- deploymentId stringRequired
ID of the deployment
Request Body
- application/json object
Input values for adding deployed models to a deployment
application/json properties
- data objectRequired
data properties
- type stringRequired
Can be one of: "deployed-models"
- attributes objectRequired
attributes properties
- deployedModelIds array of stringsRequired
IDs of all models deployed to the deployment
-
-
-
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.removeMlDeploymentModels('string', { data: { attributes: { deployedModelIds: [ 'c35f4b70-3ce4-4a30-b62b-2aef16943bc4', ], }, type: 'deployed-models', },})qlik ml deployment model remove 'string' \ --data-attributes-deployedModelIds 'c35f4b70-3ce4-4a30-b62b-2aef16943bc4' \ --data-type 'deployed-models'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/models/actions/remove" \-X POST \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '{"data":{"type":"deployed-models","attributes":{"deployedModelIds":["c35f4b70-3ce4-4a30-b62b-2aef16943bc4"]}}}'Facts
| Rate limit | Tier 2 (100 requests per minute) |
Query Parameters
- includeNotPredictedReason boolean
If true, reason why a prediction was not produced included response
- includeShap boolean
If true, shapley values included in response
- includeSource boolean
If true, source data included in response
- index string
The name of the feature in the source data to use as an index in the response data. The column will be included with its original name and values. This is intended to allow the caller to join results with source data.
Path Parameters
- deploymentId stringRequired
ID of the deployment
Request Body
- application/json object
Input values for creating realtime predictions
application/json properties
- rows array of arrays
Rows of the dataset from which to produce predictions. Date features must be in ISO 8601 format.
- schema array of objects
List of features in the dataset.
schema properties
- name string
The name of a feature in the dataset
-
-
Responses
200
Stream of combined prediction output returned successfully.
- application/json object
Input values for creating realtime predictions
application/json properties
- data object
data properties
- type string
Can be one of: "realtime-prediction"
- attributes object
attributes properties
- rows array of arrays
Rows of the dataset from which to produce predictions
- schema array of objects
List of features in the dataset
schema properties
- name string
The name of a feature in the dataset
-
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
409
Conflict
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.runMlDeploymentRealtimePredictions( 'string', {}, { rows: [['string']], schema: [{ name: 'string' }], },)qlik ml deployment realtime-prediction 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/deployments/{deploymentId}/realtime-predictions/actions/run" \-X POST \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '{"rows":[["string"]],"schema":[{"name":"string"}]}'Example Response
{ "data": { "type": "realtime-prediction", "attributes": { "rows": [ [ "string" ] ], "schema": [ { "name": "string" } ] } }}Retrieves a list of experiments based on provided filter and sort parameters.
Facts
| Rate limit | Tier 1 (1000 requests per minute) |
Query Parameters
- filter string
Experiment fields by which you can filter responses within this tenant
ownerIdID string - ID of the owner/user that created the experimentspaceIdID string (or empty string for personal space) - ID of the space where the experiment is saved.experimentVersionIdUUID string - ID of an experiment version in the experimentmodelIdUUID string - ID of a model associated with the experimentdeploymentIdUUID string - ID of a deployment of a model associated with the experiment
- sort string
Field(s) by which to sort response
Can be one of: "createdAt""+createdAt""-createdAt""description""+description""-description""name""+name""-name""updatedAt""+updatedAt""-updatedAt"
- limit integer
Number of results per page. Default is 32.
- offset integer
Number of rows to skip before getting page[size]
Responses
200
OK
- application/json object
application/json properties
- data array of objectsRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "experiment"
- attributes objectRequired
An AutoML experiment
attributes properties
- id stringRequired Filterable
ID of this entity
- name string
Name of this entity
- ownerId stringRequired Filterable
ID of owner/user for this entity
- spaceId stringRequired Filterable
Space ID for this entity (empty string for personal space)
- tenantId stringRequired Filterable
Tenant ID for this entity
- createdAt stringRequired
Timestamp when this was created
- updatedAt stringRequired
Timestamp when this was updated
- description string
Description of this entity
-
-
- meta object
Meta for FIND operations
meta properties
- count integerRequired
-
- links objectRequired
Resource links included in paginated responses
links properties
- last objectRequired
last properties
- href string
Link to the last set of responses from
limitminusoffsettolimit
-
- next objectRequired
next properties
- href string
Link to the next set of responses
-
- prev objectRequired
prev properties
- href string
Link to the previous set of responses
-
- self objectRequired
self properties
- href string
Link to the current set of responses
-
- first objectRequired
first properties
- href string
Link to the first set of responses from
offset0 to count `limit``
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.getMlExperiments({})qlik ml experiment lscurl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/experiments" \-H "Authorization: Bearer <access_token>"Example Response
{ "data": [ { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "experiment", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "ownerId": "string", "spaceId": "string", "tenantId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "createdAt": "string", "updatedAt": "string", "description": "string" } } ], "meta": { "count": 42 }, "links": { "last": { "href": "string" }, "next": { "href": "string" }, "prev": { "href": "string" }, "self": { "href": "string" }, "first": { "href": "string" } }}Facts
| Rate limit | Tier 2 (100 requests per minute) |
Request Body
- application/json object
Input for creating this entity
application/json properties
- data object
Data container for ExperimentInput
data properties
- type string
Can be one of: "experiment"
- attributes object
Experiment input attributes
attributes properties
- name stringRequired Filterable
Name of this entity
- spaceId stringRequired Filterable
Space ID for this entity (empty string for personal space)
- description string
Description of this entity
-
-
-
Responses
201
Created
- application/json object
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "experiment"
- attributes objectRequired
An AutoML experiment
attributes properties
- id stringRequired Filterable
ID of this entity
- name string
Name of this entity
- ownerId stringRequired Filterable
ID of owner/user for this entity
- spaceId stringRequired Filterable
Space ID for this entity (empty string for personal space)
- tenantId stringRequired Filterable
Tenant ID for this entity
- createdAt stringRequired
Timestamp when this was created
- updatedAt stringRequired
Timestamp when this was updated
- description string
Description of this entity
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.createMlExperiment({ data: { attributes: { description: 'string', name: 'string', spaceId: 'string', }, type: 'experiment', },})qlik ml experiment create \ --data-attributes-name 'string' \ --data-attributes-spaceId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/experiments" \-X POST \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '{"data":{"type":"experiment","attributes":{"name":"string","spaceId":"string","description":"string"}}}'Example Response
{ "data": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "experiment", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "ownerId": "string", "spaceId": "string", "tenantId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "createdAt": "string", "updatedAt": "string", "description": "string" } }}Facts
| Rate limit | Tier 1 (1000 requests per minute) |
Path Parameters
- experimentId stringRequired
ID of the experiment
Responses
200
OK
- application/json object
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "experiment"
- attributes objectRequired
An AutoML experiment
attributes properties
- id stringRequired Filterable
ID of this entity
- name string
Name of this entity
- ownerId stringRequired Filterable
ID of owner/user for this entity
- spaceId stringRequired Filterable
Space ID for this entity (empty string for personal space)
- tenantId stringRequired Filterable
Tenant ID for this entity
- createdAt stringRequired
Timestamp when this was created
- updatedAt stringRequired
Timestamp when this was updated
- description string
Description of this entity
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.getMlExperiment('string')qlik ml experiment get 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/experiments/{experimentId}" \-H "Authorization: Bearer <access_token>"Example Response
{ "data": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "experiment", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "ownerId": "string", "spaceId": "string", "tenantId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "createdAt": "string", "updatedAt": "string", "description": "string" } }}Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- experimentId stringRequired
ID of the experiment
Request Body
- application/json array of objects
Experiment fields that can be patched. The following paths all require
valueto be a string:/name,/spaceId, and/descriptionapplication/json properties
- op stringRequired
All patch requests use the replace operation
Can be one of: "replace"
- path stringRequired
Path for the property you want to update
Can be one of: "/name""/description""/spaceId"
- value anyRequired
Use for fields that can be
anytype (string, number, etc.)
-
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.patchMlExperiment('string', [ { op: 'replace', path: '/name', value: 'New name', },
{ op: 'replace', path: '/description', value: 'New description', },
{ op: 'replace', path: '/spaceId', value: 'NEW_SPACE_ID', },])qlik ml experiment patch 'string' \ --op 'replace' \ --path '/name' \ --value New namecurl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/experiments/{experimentId}" \-X PATCH \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '[{"op":"replace","path":"/name","value":"New name"},{"op":"replace","path":"/description","value":"New description"},{"op":"replace","path":"/spaceId","value":"NEW_SPACE_ID"}]'Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- experimentId stringRequired
ID of the experiment
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.deleteMlExperiment('string')qlik ml experiment rm 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/experiments/{experimentId}" \-X DELETE \-H "Authorization: Bearer <access_token>"Returns model recommendations for a specified experiment, including the best-performing, fastest, and most accurate models based on evaluation metrics.
Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- experimentId stringRequired
ID of the experiment
Request Body
- application/json object
Criteria to determine which pool of models to provide recommendations from
application/json properties
- deployed boolean
Whether to only consider models that are already deployed
- algorithms array of strings
The model algorithms to consider
Values may be any of: "catboost_classifier""catboost_regression""elasticnet_regression""gaussian_nb""kneighbors_classifier""lasso_regression""lasso""lgbm_classifier""lgbm_regression""linear_regression""logistic_regression""random_forest_classifier""random_forest_regression""sgd_regression""xgb_classifier""xgb_regression"
- fullSampling boolean
Whether to only consider models with 100% sampling
- versionNumbers array of integers
The versionNumbers of the experiment versions to consider models from
-
Responses
200
OK
- application/json object
application/json properties
- data objectRequired
data properties
- type stringRequired
Can be one of: "model-recommendation"
- attributes objectRequired
Model recommendations
attributes properties
- bestModel object
A model based on an algorithm within an experiment version.
bestModel properties
- id string
ID of this entity
- name string
Name of this entity
- errors array of objects
JSON string with list of error objects
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- hpoNum number
Version number of the hyperparameter optimization
- seqNum number
Model sequence number within the experiment version
- status string
Model status. These are the status of the model in relation to experiments (i.e. training status).
Can be one of: "pending""training_requested""training_done""ready""error"
- columns array of strings
Dataset columns selected as features
- metrics object
Model metrics based on the type of model
metrics properties
- binary object
Binary metrics for categorical values with two options. Details: https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/AutoML/scoring-binary-classification.htm
binary properties
- f1 number
The harmonic mean of precision and recall for training data
- auc number
Area under curve (training data)
- mcc number
Matthews correlation coefficient (training data)
- npv number
Negative predictive value (training data)
- f1Test number
The harmonic mean of precision and recall for test data
- recall number
The true positive rate (training data)
- aucTest number
Area under curve (test data)
- fallout number
The false positive rate (training data)
- logLoss number
Measures accuracy in logistic regression (training data)
- mccTest number
Matthews correlation coefficient (test data)
- npvTest number
Negative predictive value (test data)
- accuracy number
Average measure of how often the model made correct predictions (training data)
- missRate number
The false negative rate (training data)
- precision number
Positive predictive value. Probability that the model was correct when it predicted something was true. (training data)
- threshold number
Probability that a prediction is true (training data)
- recallTest number
The true positive rate (test data)
- falloutTest number
The false positive rate (test data)
- logLossTest number
Measures accuracy in logistic regression (test data)
- specificity number
The true negative rate (training data)
- accuracyTest number
Average measure of how often the model made correct predictions (test data)
- missRateTest number
The false negative rate (test data)
- trueNegative number
Actual false values correctly predicted as false (training data)
- truePositive number
Actual true values correctly predicted as true (training data)
- falseNegative number
Actual true values incorrectly predicted as false (training data)
- falsePositive number
Actual false values incorrectly predicted as true (training data)
- precisionTest number
Positive predictive value. Probability that the model was correct when it predicted something was true. (test data)
- thresholdTest number
Probability that a prediction is true (test data)
- specificityTest number
The true negative rate (test data)
- trueNegativeTest number
Actual false values correctly predicted as false (test data)
- truePositiveTest number
Actual true values correctly predicted as true (test data)
- falseNegativeTest number
Actual true values incorrectly predicted as false (test data)
- falsePositiveTest number
Actual false values incorrectly predicted as true (test data)
-
- multiclass object
Multiclass metrics for categorical values with 3+ options. Details: https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/AutoML/scoring-multiclass-classification.htm
multiclass properties
- f1Macro number
Macro F1 is the averaged F1 value for each class without weighting (training data)
- f1Micro number
Micro F1 is the F1 value calculated across the entire confusion matrix (training data)
- accuracy number
Average of how often the model made a correct prediction (training data)
- f1Weighted number
Weighted F1 (training data)
- f1MacroTest number
Macro F1 is the averaged F1 value for each class without weighting (test data)
- f1MicroTest number
Micro F1 is the F1 value calculated across the entire confusion matrix (test data)
- accuracyTest number
Average of how often the model made a correct prediction (test data)
- f1WeightedTest number
Weighted F1 (test data)
- confusionMatrix string
A matrix summary of the accuracy of predictions in a classification model (training data)
- confusionMatrixTest string
A matrix summary of the accuracy of predictions in a classification model (training data)
-
- regression object
Regression metrics for numeric values. Details: https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/AutoML/scoring-regression.htm
regression properties
- r2 number
R squared (training data)
- mae number
Mean absolute error (training data)
- mse number
Mean squared error (training data)
- rmse number
Root mean squared error (training data)
- r2Test number
R squared (test data)
- maeTest number
Mean absolute error (test data)
- mseTest number
Mean squared error (test data)
- rmseTest number
Root mean squared error (test data)
-
- timeseries object
Timeseries metrics experiments valid for timeseries forecasting.
timeseries properties
- mae number
Mean absolute error (training data)
- mape number
Mean absolute percentage error (training data)
- mase number
Mean absolute scaled error (training data)
- rmse number
Root mean squared error (training data)
- mdape number
Median absolute percentage error (training data)
- smape number
Symmetric mean absolute percentage error (training data)
- wmape number
Weighted mean absolute percentage error (training data)
- mnrmse number
Mean root mean squared error (training data)
- maeTest number
Mean absolute error (test data)
- mdnrmse number
Median root mean squared error (training data)
- mapeTest number
Mean absolute percentage error (test data)
- maseTest number
Mean absolute scaled error (test data)
- rmseTest number
Root mean squared error (test data)
- mdapeTest number
Median absolute percentage error (test data)
- smapeTest number
Symmetric mean absolute percentage error (test data)
- wmapeTest number
Weighted mean absolute percentage error (test data)
- mnrmseTest number
Mean root mean squared error (test data)
- mdnrmseTest number
Median root mean squared error (test data)
-
- predictionSpeed numberRequired
This represents model prediction speed in rows/second
-
- batchNum number
Batch number indicates the index of the experiment version fold (most relevant when HPO is enabled)
- algoAbbrv string
Model algorithm name abbreviation
Can be one of: "CATBC""CATBR""ELNC""GNBC""LGBMC""LGBMR""LINR""LOGC""LSOC""RAFC""RAFR""SGDR""XGBC""XGBR"
- algorithm string
The algorithm used by this model
- createdAt string
Timestamp when this was created
- updatedAt string
Timestamp when this was updated
- modelState string
Model state. These are the state of the model in relation to deployments.
Can be one of: "pending""enabled""disabled""inactive"
- description string
Description of this entity
- anomalyRatio number
- errorMessage string
JSON string of error object
- samplingRatio number
Ratio of sample data in relation to the dataset
- binningFeatures array of strings
- droppedFeatures array of objects
Features dropped because they're unsuitable
droppedFeatures properties
- name string
Name of dropped feature in the dataset
- reason string
Reason the feature was dropped
Can be one of: "highly_correlated""has_target_leakage""is_date_engineered""feature_with_low_importance"
-
- experimentVersionId string
ID of the experiment version
- powerTransformFeatures array of strings
- binaryImbalanceSampling object
binaryImbalanceSampling properties
- sampleClass string
- sampleRatio number
- sampleDirection string
Can be one of: "up""down"
-
-
- fastestModel object
A model based on an algorithm within an experiment version.
fastestModel properties
- id string
ID of this entity
- name string
Name of this entity
- errors array of objects
JSON string with list of error objects
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- hpoNum number
Version number of the hyperparameter optimization
- seqNum number
Model sequence number within the experiment version
- status string
Model status. These are the status of the model in relation to experiments (i.e. training status).
Can be one of: "pending""training_requested""training_done""ready""error"
- columns array of strings
Dataset columns selected as features
- metrics object
Model metrics based on the type of model
metrics properties
- binary object
Binary metrics for categorical values with two options. Details: https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/AutoML/scoring-binary-classification.htm
binary properties
- f1 number
The harmonic mean of precision and recall for training data
- auc number
Area under curve (training data)
- mcc number
Matthews correlation coefficient (training data)
- npv number
Negative predictive value (training data)
- f1Test number
The harmonic mean of precision and recall for test data
- recall number
The true positive rate (training data)
- aucTest number
Area under curve (test data)
- fallout number
The false positive rate (training data)
- logLoss number
Measures accuracy in logistic regression (training data)
- mccTest number
Matthews correlation coefficient (test data)
- npvTest number
Negative predictive value (test data)
- accuracy number
Average measure of how often the model made correct predictions (training data)
- missRate number
The false negative rate (training data)
- precision number
Positive predictive value. Probability that the model was correct when it predicted something was true. (training data)
- threshold number
Probability that a prediction is true (training data)
- recallTest number
The true positive rate (test data)
- falloutTest number
The false positive rate (test data)
- logLossTest number
Measures accuracy in logistic regression (test data)
- specificity number
The true negative rate (training data)
- accuracyTest number
Average measure of how often the model made correct predictions (test data)
- missRateTest number
The false negative rate (test data)
- trueNegative number
Actual false values correctly predicted as false (training data)
- truePositive number
Actual true values correctly predicted as true (training data)
- falseNegative number
Actual true values incorrectly predicted as false (training data)
- falsePositive number
Actual false values incorrectly predicted as true (training data)
- precisionTest number
Positive predictive value. Probability that the model was correct when it predicted something was true. (test data)
- thresholdTest number
Probability that a prediction is true (test data)
- specificityTest number
The true negative rate (test data)
- trueNegativeTest number
Actual false values correctly predicted as false (test data)
- truePositiveTest number
Actual true values correctly predicted as true (test data)
- falseNegativeTest number
Actual true values incorrectly predicted as false (test data)
- falsePositiveTest number
Actual false values incorrectly predicted as true (test data)
-
- multiclass object
Multiclass metrics for categorical values with 3+ options. Details: https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/AutoML/scoring-multiclass-classification.htm
multiclass properties
- f1Macro number
Macro F1 is the averaged F1 value for each class without weighting (training data)
- f1Micro number
Micro F1 is the F1 value calculated across the entire confusion matrix (training data)
- accuracy number
Average of how often the model made a correct prediction (training data)
- f1Weighted number
Weighted F1 (training data)
- f1MacroTest number
Macro F1 is the averaged F1 value for each class without weighting (test data)
- f1MicroTest number
Micro F1 is the F1 value calculated across the entire confusion matrix (test data)
- accuracyTest number
Average of how often the model made a correct prediction (test data)
- f1WeightedTest number
Weighted F1 (test data)
- confusionMatrix string
A matrix summary of the accuracy of predictions in a classification model (training data)
- confusionMatrixTest string
A matrix summary of the accuracy of predictions in a classification model (training data)
-
- regression object
Regression metrics for numeric values. Details: https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/AutoML/scoring-regression.htm
regression properties
- r2 number
R squared (training data)
- mae number
Mean absolute error (training data)
- mse number
Mean squared error (training data)
- rmse number
Root mean squared error (training data)
- r2Test number
R squared (test data)
- maeTest number
Mean absolute error (test data)
- mseTest number
Mean squared error (test data)
- rmseTest number
Root mean squared error (test data)
-
- timeseries object
Timeseries metrics experiments valid for timeseries forecasting.
timeseries properties
- mae number
Mean absolute error (training data)
- mape number
Mean absolute percentage error (training data)
- mase number
Mean absolute scaled error (training data)
- rmse number
Root mean squared error (training data)
- mdape number
Median absolute percentage error (training data)
- smape number
Symmetric mean absolute percentage error (training data)
- wmape number
Weighted mean absolute percentage error (training data)
- mnrmse number
Mean root mean squared error (training data)
- maeTest number
Mean absolute error (test data)
- mdnrmse number
Median root mean squared error (training data)
- mapeTest number
Mean absolute percentage error (test data)
- maseTest number
Mean absolute scaled error (test data)
- rmseTest number
Root mean squared error (test data)
- mdapeTest number
Median absolute percentage error (test data)
- smapeTest number
Symmetric mean absolute percentage error (test data)
- wmapeTest number
Weighted mean absolute percentage error (test data)
- mnrmseTest number
Mean root mean squared error (test data)
- mdnrmseTest number
Median root mean squared error (test data)
-
- predictionSpeed numberRequired
This represents model prediction speed in rows/second
-
- batchNum number
Batch number indicates the index of the experiment version fold (most relevant when HPO is enabled)
- algoAbbrv string
Model algorithm name abbreviation
Can be one of: "CATBC""CATBR""ELNC""GNBC""LGBMC""LGBMR""LINR""LOGC""LSOC""RAFC""RAFR""SGDR""XGBC""XGBR"
- algorithm string
The algorithm used by this model
- createdAt string
Timestamp when this was created
- updatedAt string
Timestamp when this was updated
- modelState string
Model state. These are the state of the model in relation to deployments.
Can be one of: "pending""enabled""disabled""inactive"
- description string
Description of this entity
- anomalyRatio number
- errorMessage string
JSON string of error object
- samplingRatio number
Ratio of sample data in relation to the dataset
- binningFeatures array of strings
- droppedFeatures array of objects
Features dropped because they're unsuitable
droppedFeatures properties
- name string
Name of dropped feature in the dataset
- reason string
Reason the feature was dropped
Can be one of: "highly_correlated""has_target_leakage""is_date_engineered""feature_with_low_importance"
-
- experimentVersionId string
ID of the experiment version
- powerTransformFeatures array of strings
- binaryImbalanceSampling object
binaryImbalanceSampling properties
- sampleClass string
- sampleRatio number
- sampleDirection string
Can be one of: "up""down"
-
-
- mostAccurateModel object
A model based on an algorithm within an experiment version.
mostAccurateModel properties
- id string
ID of this entity
- name string
Name of this entity
- errors array of objects
JSON string with list of error objects
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- hpoNum number
Version number of the hyperparameter optimization
- seqNum number
Model sequence number within the experiment version
- status string
Model status. These are the status of the model in relation to experiments (i.e. training status).
Can be one of: "pending""training_requested""training_done""ready""error"
- columns array of strings
Dataset columns selected as features
- metrics object
Model metrics based on the type of model
metrics properties
- binary object
Binary metrics for categorical values with two options. Details: https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/AutoML/scoring-binary-classification.htm
binary properties
- f1 number
The harmonic mean of precision and recall for training data
- auc number
Area under curve (training data)
- mcc number
Matthews correlation coefficient (training data)
- npv number
Negative predictive value (training data)
- f1Test number
The harmonic mean of precision and recall for test data
- recall number
The true positive rate (training data)
- aucTest number
Area under curve (test data)
- fallout number
The false positive rate (training data)
- logLoss number
Measures accuracy in logistic regression (training data)
- mccTest number
Matthews correlation coefficient (test data)
- npvTest number
Negative predictive value (test data)
- accuracy number
Average measure of how often the model made correct predictions (training data)
- missRate number
The false negative rate (training data)
- precision number
Positive predictive value. Probability that the model was correct when it predicted something was true. (training data)
- threshold number
Probability that a prediction is true (training data)
- recallTest number
The true positive rate (test data)
- falloutTest number
The false positive rate (test data)
- logLossTest number
Measures accuracy in logistic regression (test data)
- specificity number
The true negative rate (training data)
- accuracyTest number
Average measure of how often the model made correct predictions (test data)
- missRateTest number
The false negative rate (test data)
- trueNegative number
Actual false values correctly predicted as false (training data)
- truePositive number
Actual true values correctly predicted as true (training data)
- falseNegative number
Actual true values incorrectly predicted as false (training data)
- falsePositive number
Actual false values incorrectly predicted as true (training data)
- precisionTest number
Positive predictive value. Probability that the model was correct when it predicted something was true. (test data)
- thresholdTest number
Probability that a prediction is true (test data)
- specificityTest number
The true negative rate (test data)
- trueNegativeTest number
Actual false values correctly predicted as false (test data)
- truePositiveTest number
Actual true values correctly predicted as true (test data)
- falseNegativeTest number
Actual true values incorrectly predicted as false (test data)
- falsePositiveTest number
Actual false values incorrectly predicted as true (test data)
-
- multiclass object
Multiclass metrics for categorical values with 3+ options. Details: https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/AutoML/scoring-multiclass-classification.htm
multiclass properties
- f1Macro number
Macro F1 is the averaged F1 value for each class without weighting (training data)
- f1Micro number
Micro F1 is the F1 value calculated across the entire confusion matrix (training data)
- accuracy number
Average of how often the model made a correct prediction (training data)
- f1Weighted number
Weighted F1 (training data)
- f1MacroTest number
Macro F1 is the averaged F1 value for each class without weighting (test data)
- f1MicroTest number
Micro F1 is the F1 value calculated across the entire confusion matrix (test data)
- accuracyTest number
Average of how often the model made a correct prediction (test data)
- f1WeightedTest number
Weighted F1 (test data)
- confusionMatrix string
A matrix summary of the accuracy of predictions in a classification model (training data)
- confusionMatrixTest string
A matrix summary of the accuracy of predictions in a classification model (training data)
-
- regression object
Regression metrics for numeric values. Details: https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/AutoML/scoring-regression.htm
regression properties
- r2 number
R squared (training data)
- mae number
Mean absolute error (training data)
- mse number
Mean squared error (training data)
- rmse number
Root mean squared error (training data)
- r2Test number
R squared (test data)
- maeTest number
Mean absolute error (test data)
- mseTest number
Mean squared error (test data)
- rmseTest number
Root mean squared error (test data)
-
- timeseries object
Timeseries metrics experiments valid for timeseries forecasting.
timeseries properties
- mae number
Mean absolute error (training data)
- mape number
Mean absolute percentage error (training data)
- mase number
Mean absolute scaled error (training data)
- rmse number
Root mean squared error (training data)
- mdape number
Median absolute percentage error (training data)
- smape number
Symmetric mean absolute percentage error (training data)
- wmape number
Weighted mean absolute percentage error (training data)
- mnrmse number
Mean root mean squared error (training data)
- maeTest number
Mean absolute error (test data)
- mdnrmse number
Median root mean squared error (training data)
- mapeTest number
Mean absolute percentage error (test data)
- maseTest number
Mean absolute scaled error (test data)
- rmseTest number
Root mean squared error (test data)
- mdapeTest number
Median absolute percentage error (test data)
- smapeTest number
Symmetric mean absolute percentage error (test data)
- wmapeTest number
Weighted mean absolute percentage error (test data)
- mnrmseTest number
Mean root mean squared error (test data)
- mdnrmseTest number
Median root mean squared error (test data)
-
- predictionSpeed numberRequired
This represents model prediction speed in rows/second
-
- batchNum number
Batch number indicates the index of the experiment version fold (most relevant when HPO is enabled)
- algoAbbrv string
Model algorithm name abbreviation
Can be one of: "CATBC""CATBR""ELNC""GNBC""LGBMC""LGBMR""LINR""LOGC""LSOC""RAFC""RAFR""SGDR""XGBC""XGBR"
- algorithm string
The algorithm used by this model
- createdAt string
Timestamp when this was created
- updatedAt string
Timestamp when this was updated
- modelState string
Model state. These are the state of the model in relation to deployments.
Can be one of: "pending""enabled""disabled""inactive"
- description string
Description of this entity
- anomalyRatio number
- errorMessage string
JSON string of error object
- samplingRatio number
Ratio of sample data in relation to the dataset
- binningFeatures array of strings
- droppedFeatures array of objects
Features dropped because they're unsuitable
droppedFeatures properties
- name string
Name of dropped feature in the dataset
- reason string
Reason the feature was dropped
Can be one of: "highly_correlated""has_target_leakage""is_date_engineered""feature_with_low_importance"
-
- experimentVersionId string
ID of the experiment version
- powerTransformFeatures array of strings
- binaryImbalanceSampling object
binaryImbalanceSampling properties
- sampleClass string
- sampleRatio number
- sampleDirection string
Can be one of: "up""down"
-
-
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.recommendModelsMlExperiment( 'string', { algorithms: ['catboost_classifier'], deployed: true, fullSampling: true, versionNumbers: [1], },)qlik ml experiment recommend-models 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/experiments/{experimentId}/actions/recommend-models" \-X POST \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '{"deployed":true,"algorithms":["catboost_classifier"],"fullSampling":true,"versionNumbers":[1]}'Example Response
{ "data": { "type": "model-recommendation", "attributes": { "bestModel": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "errors": "[{\"code\":\"AML-145\",\"title\":\"datasync dependent service error, service profile\",\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\",\"meta\":{\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\"}}]\n", "hpoNum": 42, "seqNum": 42, "status": "pending", "columns": [ "string" ], "metrics": { "predictionSpeed": 42 }, "batchNum": 42, "algoAbbrv": "CATBC", "algorithm": "string", "createdAt": "string", "updatedAt": "string", "modelState": "pending", "description": "string", "anomalyRatio": 42, "errorMessage": "string", "samplingRatio": 42, "binningFeatures": [ "string" ], "droppedFeatures": [ { "name": "string", "reason": "highly_correlated" } ], "experimentVersionId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "powerTransformFeatures": [ "string" ], "binaryImbalanceSampling": { "sampleClass": "string", "sampleRatio": 42, "sampleDirection": "up" } }, "fastestModel": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "errors": "[{\"code\":\"AML-145\",\"title\":\"datasync dependent service error, service profile\",\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\",\"meta\":{\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\"}}]\n", "hpoNum": 42, "seqNum": 42, "status": "pending", "columns": [ "string" ], "metrics": { "predictionSpeed": 42 }, "batchNum": 42, "algoAbbrv": "CATBC", "algorithm": "string", "createdAt": "string", "updatedAt": "string", "modelState": "pending", "description": "string", "anomalyRatio": 42, "errorMessage": "string", "samplingRatio": 42, "binningFeatures": [ "string" ], "droppedFeatures": [ { "name": "string", "reason": "highly_correlated" } ], "experimentVersionId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "powerTransformFeatures": [ "string" ], "binaryImbalanceSampling": { "sampleClass": "string", "sampleRatio": 42, "sampleDirection": "up" } }, "mostAccurateModel": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "errors": "[{\"code\":\"AML-145\",\"title\":\"datasync dependent service error, service profile\",\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\",\"meta\":{\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\"}}]\n", "hpoNum": 42, "seqNum": 42, "status": "pending", "columns": [ "string" ], "metrics": { "predictionSpeed": 42 }, "batchNum": 42, "algoAbbrv": "CATBC", "algorithm": "string", "createdAt": "string", "updatedAt": "string", "modelState": "pending", "description": "string", "anomalyRatio": 42, "errorMessage": "string", "samplingRatio": 42, "binningFeatures": [ "string" ], "droppedFeatures": [ { "name": "string", "reason": "highly_correlated" } ], "experimentVersionId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "powerTransformFeatures": [ "string" ], "binaryImbalanceSampling": { "sampleClass": "string", "sampleRatio": 42, "sampleDirection": "up" } } } }}Facts
| Rate limit | Tier 1 (1000 requests per minute) |
Query Parameters
- filter string
Model fields you can filter by:
-
experimentVersionIdUUID string - Find by experiment version ID -
batchNumUUID string - Search by batch number -
isHpoboolean - Is hyperparameter optimization used? -
isMetricsboolean - Are metrics for regression, binary, or multiclass are used? -
idUUID string - Find by model ID -
algorithmenum string - Find by algorithm- Valid algorithms: catboost_classifier, catboost_regression,
elasticnet_regression, gaussian_nb, kneighbors_classifier,
lasso_regression, lasso, lgbm_classifier, lgbm_regression,
linear_regression, logistic_regression, random_forest_classifier,
random_forest_regression, sgd_regression, xgb_classifier,
xgb_regression
- Valid algorithms: catboost_classifier, catboost_regression,
elasticnet_regression, gaussian_nb, kneighbors_classifier,
lasso_regression, lasso, lgbm_classifier, lgbm_regression,
linear_regression, logistic_regression, random_forest_classifier,
random_forest_regression, sgd_regression, xgb_classifier,
xgb_regression
-
statusenum string - find by status- Valid statuses: pending, training_requested, training_done, ready, error
- Valid statuses: pending, training_requested, training_done, ready, error
-
hasDeploymentboolean - Models that are part of a deployment -
nameContainsstring - Models with name includes this case-insensitive string -
exactNamestring - Models with exact name. Model names may not be unique -
samplingRationumber - Find models by sampling ratio -
modelStateenum string - State by which to find models- Valid states:
pending, enabled, disabled, inactive
- Valid states:
-
- sort string
Field(s) by which to sort response
Can be one of: "createdAt""+createdAt""-createdAt""description""+description""-description""name""+name""-name""updatedAt""+updatedAt""-updatedAt"
- limit integer
Number of results per page. Default is 32.
- offset integer
Number of rows to skip before getting page[size]
Path Parameters
- experimentId stringRequired
ID of the experiment
Responses
200
OK
- application/json object
application/json properties
- data array of objectsRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "model"
- attributes objectRequired
A model based on an algorithm within an experiment version.
attributes properties
- id string
ID of this entity
- name string
Name of this entity
- errors array of objects
JSON string with list of error objects
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- hpoNum number
Version number of the hyperparameter optimization
- seqNum number
Model sequence number within the experiment version
- status string
Model status. These are the status of the model in relation to experiments (i.e. training status).
Can be one of: "pending""training_requested""training_done""ready""error"
- columns array of strings
Dataset columns selected as features
- metrics object
Model metrics based on the type of model
metrics properties
- binary object
Binary metrics for categorical values with two options. Details: https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/AutoML/scoring-binary-classification.htm
binary properties
- f1 number
The harmonic mean of precision and recall for training data
- auc number
Area under curve (training data)
- mcc number
Matthews correlation coefficient (training data)
- npv number
Negative predictive value (training data)
- f1Test number
The harmonic mean of precision and recall for test data
- recall number
The true positive rate (training data)
- aucTest number
Area under curve (test data)
- fallout number
The false positive rate (training data)
- logLoss number
Measures accuracy in logistic regression (training data)
- mccTest number
Matthews correlation coefficient (test data)
- npvTest number
Negative predictive value (test data)
- accuracy number
Average measure of how often the model made correct predictions (training data)
- missRate number
The false negative rate (training data)
- precision number
Positive predictive value. Probability that the model was correct when it predicted something was true. (training data)
- threshold number
Probability that a prediction is true (training data)
- recallTest number
The true positive rate (test data)
- falloutTest number
The false positive rate (test data)
- logLossTest number
Measures accuracy in logistic regression (test data)
- specificity number
The true negative rate (training data)
- accuracyTest number
Average measure of how often the model made correct predictions (test data)
- missRateTest number
The false negative rate (test data)
- trueNegative number
Actual false values correctly predicted as false (training data)
- truePositive number
Actual true values correctly predicted as true (training data)
- falseNegative number
Actual true values incorrectly predicted as false (training data)
- falsePositive number
Actual false values incorrectly predicted as true (training data)
- precisionTest number
Positive predictive value. Probability that the model was correct when it predicted something was true. (test data)
- thresholdTest number
Probability that a prediction is true (test data)
- specificityTest number
The true negative rate (test data)
- trueNegativeTest number
Actual false values correctly predicted as false (test data)
- truePositiveTest number
Actual true values correctly predicted as true (test data)
- falseNegativeTest number
Actual true values incorrectly predicted as false (test data)
- falsePositiveTest number
Actual false values incorrectly predicted as true (test data)
-
- multiclass object
Multiclass metrics for categorical values with 3+ options. Details: https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/AutoML/scoring-multiclass-classification.htm
multiclass properties
- f1Macro number
Macro F1 is the averaged F1 value for each class without weighting (training data)
- f1Micro number
Micro F1 is the F1 value calculated across the entire confusion matrix (training data)
- accuracy number
Average of how often the model made a correct prediction (training data)
- f1Weighted number
Weighted F1 (training data)
- f1MacroTest number
Macro F1 is the averaged F1 value for each class without weighting (test data)
- f1MicroTest number
Micro F1 is the F1 value calculated across the entire confusion matrix (test data)
- accuracyTest number
Average of how often the model made a correct prediction (test data)
- f1WeightedTest number
Weighted F1 (test data)
- confusionMatrix string
A matrix summary of the accuracy of predictions in a classification model (training data)
- confusionMatrixTest string
A matrix summary of the accuracy of predictions in a classification model (training data)
-
- regression object
Regression metrics for numeric values. Details: https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/AutoML/scoring-regression.htm
regression properties
- r2 number
R squared (training data)
- mae number
Mean absolute error (training data)
- mse number
Mean squared error (training data)
- rmse number
Root mean squared error (training data)
- r2Test number
R squared (test data)
- maeTest number
Mean absolute error (test data)
- mseTest number
Mean squared error (test data)
- rmseTest number
Root mean squared error (test data)
-
- timeseries object
Timeseries metrics experiments valid for timeseries forecasting.
timeseries properties
- mae number
Mean absolute error (training data)
- mape number
Mean absolute percentage error (training data)
- mase number
Mean absolute scaled error (training data)
- rmse number
Root mean squared error (training data)
- mdape number
Median absolute percentage error (training data)
- smape number
Symmetric mean absolute percentage error (training data)
- wmape number
Weighted mean absolute percentage error (training data)
- mnrmse number
Mean root mean squared error (training data)
- maeTest number
Mean absolute error (test data)
- mdnrmse number
Median root mean squared error (training data)
- mapeTest number
Mean absolute percentage error (test data)
- maseTest number
Mean absolute scaled error (test data)
- rmseTest number
Root mean squared error (test data)
- mdapeTest number
Median absolute percentage error (test data)
- smapeTest number
Symmetric mean absolute percentage error (test data)
- wmapeTest number
Weighted mean absolute percentage error (test data)
- mnrmseTest number
Mean root mean squared error (test data)
- mdnrmseTest number
Median root mean squared error (test data)
-
- predictionSpeed number
Model prediction speed in rows/second (from recommend-models endpoint)
-
- batchNum number
Batch number indicates the index of the experiment version fold (most relevant when HPO is enabled)
- algoAbbrv string
Model algorithm name abbreviation
Can be one of: "CATBC""CATBR""ELNC""GNBC""LGBMC""LGBMR""LINR""LOGC""LSOC""RAFC""RAFR""SGDR""XGBC""XGBR"
- algorithm string
The algorithm used by this model
- createdAt string
Timestamp when this was created
- updatedAt string
Timestamp when this was updated
- modelState string
Model state. These are the state of the model in relation to deployments.
Can be one of: "pending""enabled""disabled""inactive"
- description string
Description of this entity
- anomalyRatio number
- errorMessage string
JSON string of error object
- samplingRatio number
Ratio of sample data in relation to the dataset
- binningFeatures array of strings
- droppedFeatures array of objects
Features dropped because they're unsuitable
droppedFeatures properties
- name string
Name of dropped feature in the dataset
- reason string
Reason the feature was dropped
Can be one of: "highly_correlated""has_target_leakage""is_date_engineered""feature_with_low_importance"
-
- experimentVersionId string
ID of the experiment version
- powerTransformFeatures array of strings
- binaryImbalanceSampling object
binaryImbalanceSampling properties
- sampleClass string
- sampleRatio number
- sampleDirection string
Can be one of: "up""down"
-
-
-
- meta object
Meta for FIND operations
meta properties
- count integerRequired
-
- links objectRequired
Resource links included in paginated responses
links properties
- last objectRequired
last properties
- href string
Link to the last set of responses from
limitminusoffsettolimit
-
- next objectRequired
next properties
- href string
Link to the next set of responses
-
- prev objectRequired
prev properties
- href string
Link to the previous set of responses
-
- self objectRequired
self properties
- href string
Link to the current set of responses
-
- first objectRequired
first properties
- href string
Link to the first set of responses from
offset0 to count `limit``
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.getMlExperimentModels('string', {})qlik ml experiment model ls \ --experimentId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/experiments/{experimentId}/models" \-H "Authorization: Bearer <access_token>"Example Response
{ "data": [ { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "model", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "errors": "[{\"code\":\"AML-145\",\"title\":\"datasync dependent service error, service profile\",\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\",\"meta\":{\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\"}}]\n", "hpoNum": 42, "seqNum": 42, "status": "pending", "columns": [ "string" ], "metrics": { "binary": { "f1": 42, "auc": 42, "mcc": 42, "npv": 42, "f1Test": 42, "recall": 42, "aucTest": 42, "fallout": 42, "logLoss": 42, "mccTest": 42, "npvTest": 42, "accuracy": 42, "missRate": 42, "precision": 42, "threshold": 42, "recallTest": 42, "falloutTest": 42, "logLossTest": 42, "specificity": 42, "accuracyTest": 42, "missRateTest": 42, "trueNegative": 42, "truePositive": 42, "falseNegative": 42, "falsePositive": 42, "precisionTest": 42, "thresholdTest": 42, "specificityTest": 42, "trueNegativeTest": 42, "truePositiveTest": 42, "falseNegativeTest": 42, "falsePositiveTest": 42 }, "multiclass": { "f1Macro": 42, "f1Micro": 42, "accuracy": 42, "f1Weighted": 42, "f1MacroTest": 42, "f1MicroTest": 42, "accuracyTest": 42, "f1WeightedTest": 42, "confusionMatrix": "string", "confusionMatrixTest": "string" }, "regression": { "r2": 42, "mae": 42, "mse": 42, "rmse": 42, "r2Test": 42, "maeTest": 42, "mseTest": 42, "rmseTest": 42 }, "timeseries": { "mae": 42, "mape": 42, "mase": 42, "rmse": 42, "mdape": 42, "smape": 42, "wmape": 42, "mnrmse": 42, "maeTest": 42, "mdnrmse": 42, "mapeTest": 42, "maseTest": 42, "rmseTest": 42, "mdapeTest": 42, "smapeTest": 42, "wmapeTest": 42, "mnrmseTest": 42, "mdnrmseTest": 42 }, "predictionSpeed": 42 }, "batchNum": 42, "algoAbbrv": "CATBC", "algorithm": "string", "createdAt": "string", "updatedAt": "string", "modelState": "pending", "description": "string", "anomalyRatio": 42, "errorMessage": "string", "samplingRatio": 42, "binningFeatures": [ "string" ], "droppedFeatures": [ { "name": "string", "reason": "highly_correlated" } ], "experimentVersionId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "powerTransformFeatures": [ "string" ], "binaryImbalanceSampling": { "sampleClass": "string", "sampleRatio": 42, "sampleDirection": "up" } } } ], "meta": { "count": 42 }, "links": { "last": { "href": "string" }, "next": { "href": "string" }, "prev": { "href": "string" }, "self": { "href": "string" }, "first": { "href": "string" } }}Facts
| Rate limit | Tier 1 (1000 requests per minute) |
Path Parameters
- experimentId stringRequired
ID of the experiment
- modelId stringRequired
ID of the model
Responses
200
OK
- application/json object
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "model"
- attributes objectRequired
A model based on an algorithm within an experiment version.
attributes properties
- id string
ID of this entity
- name string
Name of this entity
- errors array of objects
JSON string with list of error objects
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- hpoNum number
Version number of the hyperparameter optimization
- seqNum number
Model sequence number within the experiment version
- status string
Model status. These are the status of the model in relation to experiments (i.e. training status).
Can be one of: "pending""training_requested""training_done""ready""error"
- columns array of strings
Dataset columns selected as features
- metrics object
Model metrics based on the type of model
metrics properties
- binary object
Binary metrics for categorical values with two options. Details: https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/AutoML/scoring-binary-classification.htm
binary properties
- f1 number
The harmonic mean of precision and recall for training data
- auc number
Area under curve (training data)
- mcc number
Matthews correlation coefficient (training data)
- npv number
Negative predictive value (training data)
- f1Test number
The harmonic mean of precision and recall for test data
- recall number
The true positive rate (training data)
- aucTest number
Area under curve (test data)
- fallout number
The false positive rate (training data)
- logLoss number
Measures accuracy in logistic regression (training data)
- mccTest number
Matthews correlation coefficient (test data)
- npvTest number
Negative predictive value (test data)
- accuracy number
Average measure of how often the model made correct predictions (training data)
- missRate number
The false negative rate (training data)
- precision number
Positive predictive value. Probability that the model was correct when it predicted something was true. (training data)
- threshold number
Probability that a prediction is true (training data)
- recallTest number
The true positive rate (test data)
- falloutTest number
The false positive rate (test data)
- logLossTest number
Measures accuracy in logistic regression (test data)
- specificity number
The true negative rate (training data)
- accuracyTest number
Average measure of how often the model made correct predictions (test data)
- missRateTest number
The false negative rate (test data)
- trueNegative number
Actual false values correctly predicted as false (training data)
- truePositive number
Actual true values correctly predicted as true (training data)
- falseNegative number
Actual true values incorrectly predicted as false (training data)
- falsePositive number
Actual false values incorrectly predicted as true (training data)
- precisionTest number
Positive predictive value. Probability that the model was correct when it predicted something was true. (test data)
- thresholdTest number
Probability that a prediction is true (test data)
- specificityTest number
The true negative rate (test data)
- trueNegativeTest number
Actual false values correctly predicted as false (test data)
- truePositiveTest number
Actual true values correctly predicted as true (test data)
- falseNegativeTest number
Actual true values incorrectly predicted as false (test data)
- falsePositiveTest number
Actual false values incorrectly predicted as true (test data)
-
- multiclass object
Multiclass metrics for categorical values with 3+ options. Details: https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/AutoML/scoring-multiclass-classification.htm
multiclass properties
- f1Macro number
Macro F1 is the averaged F1 value for each class without weighting (training data)
- f1Micro number
Micro F1 is the F1 value calculated across the entire confusion matrix (training data)
- accuracy number
Average of how often the model made a correct prediction (training data)
- f1Weighted number
Weighted F1 (training data)
- f1MacroTest number
Macro F1 is the averaged F1 value for each class without weighting (test data)
- f1MicroTest number
Micro F1 is the F1 value calculated across the entire confusion matrix (test data)
- accuracyTest number
Average of how often the model made a correct prediction (test data)
- f1WeightedTest number
Weighted F1 (test data)
- confusionMatrix string
A matrix summary of the accuracy of predictions in a classification model (training data)
- confusionMatrixTest string
A matrix summary of the accuracy of predictions in a classification model (training data)
-
- regression object
Regression metrics for numeric values. Details: https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/AutoML/scoring-regression.htm
regression properties
- r2 number
R squared (training data)
- mae number
Mean absolute error (training data)
- mse number
Mean squared error (training data)
- rmse number
Root mean squared error (training data)
- r2Test number
R squared (test data)
- maeTest number
Mean absolute error (test data)
- mseTest number
Mean squared error (test data)
- rmseTest number
Root mean squared error (test data)
-
- timeseries object
Timeseries metrics experiments valid for timeseries forecasting.
timeseries properties
- mae number
Mean absolute error (training data)
- mape number
Mean absolute percentage error (training data)
- mase number
Mean absolute scaled error (training data)
- rmse number
Root mean squared error (training data)
- mdape number
Median absolute percentage error (training data)
- smape number
Symmetric mean absolute percentage error (training data)
- wmape number
Weighted mean absolute percentage error (training data)
- mnrmse number
Mean root mean squared error (training data)
- maeTest number
Mean absolute error (test data)
- mdnrmse number
Median root mean squared error (training data)
- mapeTest number
Mean absolute percentage error (test data)
- maseTest number
Mean absolute scaled error (test data)
- rmseTest number
Root mean squared error (test data)
- mdapeTest number
Median absolute percentage error (test data)
- smapeTest number
Symmetric mean absolute percentage error (test data)
- wmapeTest number
Weighted mean absolute percentage error (test data)
- mnrmseTest number
Mean root mean squared error (test data)
- mdnrmseTest number
Median root mean squared error (test data)
-
- predictionSpeed number
Model prediction speed in rows/second (from recommend-models endpoint)
-
- batchNum number
Batch number indicates the index of the experiment version fold (most relevant when HPO is enabled)
- algoAbbrv string
Model algorithm name abbreviation
Can be one of: "CATBC""CATBR""ELNC""GNBC""LGBMC""LGBMR""LINR""LOGC""LSOC""RAFC""RAFR""SGDR""XGBC""XGBR"
- algorithm string
The algorithm used by this model
- createdAt string
Timestamp when this was created
- updatedAt string
Timestamp when this was updated
- modelState string
Model state. These are the state of the model in relation to deployments.
Can be one of: "pending""enabled""disabled""inactive"
- description string
Description of this entity
- anomalyRatio number
- errorMessage string
JSON string of error object
- samplingRatio number
Ratio of sample data in relation to the dataset
- binningFeatures array of strings
- droppedFeatures array of objects
Features dropped because they're unsuitable
droppedFeatures properties
- name string
Name of dropped feature in the dataset
- reason string
Reason the feature was dropped
Can be one of: "highly_correlated""has_target_leakage""is_date_engineered""feature_with_low_importance"
-
- experimentVersionId string
ID of the experiment version
- powerTransformFeatures array of strings
- binaryImbalanceSampling object
binaryImbalanceSampling properties
- sampleClass string
- sampleRatio number
- sampleDirection string
Can be one of: "up""down"
-
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.getMlExperimentModel( 'string', 'string',)qlik ml experiment model get 'string' \ --experimentId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/experiments/{experimentId}/models/{modelId}" \-H "Authorization: Bearer <access_token>"Example Response
{ "data": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "model", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "errors": "[{\"code\":\"AML-145\",\"title\":\"datasync dependent service error, service profile\",\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\",\"meta\":{\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\"}}]\n", "hpoNum": 42, "seqNum": 42, "status": "pending", "columns": [ "string" ], "metrics": { "binary": { "f1": 42, "auc": 42, "mcc": 42, "npv": 42, "f1Test": 42, "recall": 42, "aucTest": 42, "fallout": 42, "logLoss": 42, "mccTest": 42, "npvTest": 42, "accuracy": 42, "missRate": 42, "precision": 42, "threshold": 42, "recallTest": 42, "falloutTest": 42, "logLossTest": 42, "specificity": 42, "accuracyTest": 42, "missRateTest": 42, "trueNegative": 42, "truePositive": 42, "falseNegative": 42, "falsePositive": 42, "precisionTest": 42, "thresholdTest": 42, "specificityTest": 42, "trueNegativeTest": 42, "truePositiveTest": 42, "falseNegativeTest": 42, "falsePositiveTest": 42 }, "multiclass": { "f1Macro": 42, "f1Micro": 42, "accuracy": 42, "f1Weighted": 42, "f1MacroTest": 42, "f1MicroTest": 42, "accuracyTest": 42, "f1WeightedTest": 42, "confusionMatrix": "string", "confusionMatrixTest": "string" }, "regression": { "r2": 42, "mae": 42, "mse": 42, "rmse": 42, "r2Test": 42, "maeTest": 42, "mseTest": 42, "rmseTest": 42 }, "timeseries": { "mae": 42, "mape": 42, "mase": 42, "rmse": 42, "mdape": 42, "smape": 42, "wmape": 42, "mnrmse": 42, "maeTest": 42, "mdnrmse": 42, "mapeTest": 42, "maseTest": 42, "rmseTest": 42, "mdapeTest": 42, "smapeTest": 42, "wmapeTest": 42, "mnrmseTest": 42, "mdnrmseTest": 42 }, "predictionSpeed": 42 }, "batchNum": 42, "algoAbbrv": "CATBC", "algorithm": "string", "createdAt": "string", "updatedAt": "string", "modelState": "pending", "description": "string", "anomalyRatio": 42, "errorMessage": "string", "samplingRatio": 42, "binningFeatures": [ "string" ], "droppedFeatures": [ { "name": "string", "reason": "highly_correlated" } ], "experimentVersionId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "powerTransformFeatures": [ "string" ], "binaryImbalanceSampling": { "sampleClass": "string", "sampleRatio": 42, "sampleDirection": "up" } } }}Facts
| Rate limit | Tier 1 (1000 requests per minute) |
Query Parameters
- filter string
Experiment version filter options
isRunningboolean - Is the experiment version running (training models)?isSettledboolean - Is the experiment version settled?statusenum string - Status to filter by. Omit to get models of any status.- Valid statuses: pending, ready, error, cancelled
modelIdUUID string - ID of a model associated with the experiment
- sort string
Field(s) by which to sort response
Can be one of: "createdAt""+createdAt""-createdAt""description""+description""-description""experimentMode""+experimentMode""-experimentMode""experimentType""+experimentType""-experimentType""name""+name""-name""status""+status""-status""updatedAt""+updatedAt""-updatedAt""versionNumber""+versionNumber""-versionNumber"
- limit integer
Number of results per page. Default is 32.
- offset integer
Number of rows to skip before getting page[size]
Path Parameters
- experimentId stringRequired
ID of the experiment
Responses
200
OK
- application/json object
application/json properties
- data array of objectsRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "experiment-version"
- attributes objectRequired
An AutoML experiment version. This is a configuration for training models within an experiment.
attributes properties
- id stringRequired Filterable
ID of this entity
- name string
Name of this entity
- errors array of objects
JSON string with list of error objects
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- status stringRequired Filterable
Current status of this entity
Can be one of: "ready""error""cancelled""pending""dataprep_requested""datasync_requested""datasync_done"
- target stringRequired
The target field in the dataset
- pipeline object
Pipeline metadata including transformations to apply to columns and specific schema configuration data
pipeline properties
- transforms array of objects
transforms properties
- column object
column properties
- name stringRequired
- changeType stringRequired
-
-
-
- createdAt stringRequired
Timestamp when this was created
- dataSetId stringRequired
The Qlik catalog dataset ID
- profileId string
ID of the dataset profile with metadata about source data
- updatedAt stringRequired
Timestamp when this was updated
- algorithms array of strings
List of algorithms selected for model training in this version
Values may be any of: "catboost_classifier""catboost_regression""elasticnet_regression""gaussian_nb""kneighbors_classifier""lasso_regression""lasso""lgbm_classifier""lgbm_regression""linear_regression""logistic_regression""random_forest_classifier""random_forest_regression""sgd_regression""xgb_classifier""xgb_regression"
- topModelId string
ID of the top model (based on training scores) in this experiment version
- dateIndexes array of strings
A optional date column name to index
- errorMessage string
JSON string of error object
- experimentId stringRequired
ID of the experiment
- featuresList array of objects
List of features from your dataset for creating Experiment Versions. This appears in from ProfileInsights response (in the defaultVersionConfig). You can adjust the default settings before using it as input to create or update Experiment Versions.
featuresList properties
- name string
Name of the feature column
- include boolean
Include this feature in your experiment version? Default here is based on insights for this feature (e.g. willBeDropped).
- dataType string
The data type of this feature in your dataset
Can be one of: "DATE""TIME""DATETIME""TIMESTAMP""STRING""DOUBLE""DECIMAL""INTEGER""BOOLEAN""BINARY""CUSTOM""FLOAT""OBJECT"
- changeType string
Indicates if you want to change the featureType for this feature within the experiment version
Can be one of: "categorical""numeric""date""freetext"
- featureType string
The default feature type based on the feature's data type. If you want a value to be interpreted differently (e.g. 0/1 as categorical/boolean instead of numeric), use
changeType.Can be one of: "categorical""numeric""date""freetext"
- parentFeature string
The parent feature name for engineered features. e.g.
OrderDatemay be the parent of its engineered features (features extracted from parent) likeOrderDate.YEAR,OrderDate.MONTH, etc.
-
- lastBatchNum integer
Number of the last batch
- datasetOrigin string
Whether this is a new or other dataset
Can be one of: "new""changed""refreshed""same"
- versionNumber integer
- -based sequential version number within the experiment
- experimentMode string
The model training mode for the experiment version
Can be one of: "intelligent""manual""manual_hpo"
- experimentType stringRequired
Experiment type
Can be one of: "binary""multiclass""regression"
- createdByUserId stringRequired Filterable
ID of owner/user for this entity
- trainingDuration integer
Maximum allowed training duration in seconds, not elapsed training time.
- maxTrainingDuration integer
Maximum allowed training duration in seconds, not elapsed training time.
- preprocessedInsights array of objects
Preprocessed insights. Like feature insights but with fewer details.
preprocessedInsights properties
- name stringRequired
Name of the preprocessed insight column
- insights array of stringsRequired
Preliminary list of column/feature insights available after preprocessing but before feature insights are available
Values may be any of: "is_free_text""cannot_be_processed_as_free_text""is_date_engineered""has_target_leakage""feature_type_change_invalid""feature_type_change_failed""feature_type_change_successful""data_bias_detected""representation_bias_detected"
- willBeDropped booleanRequired
Whether this feature insight will be dropped due to free text or high cardinality that makes it less useful
-
-
-
- meta object
Meta for FIND operations
meta properties
- count integerRequired
-
- links objectRequired
Resource links included in paginated responses
links properties
- last objectRequired
last properties
- href string
Link to the last set of responses from
limitminusoffsettolimit
-
- next objectRequired
next properties
- href string
Link to the next set of responses
-
- prev objectRequired
prev properties
- href string
Link to the previous set of responses
-
- self objectRequired
self properties
- href string
Link to the current set of responses
-
- first objectRequired
first properties
- href string
Link to the first set of responses from
offset0 to count `limit``
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.getMlExperimentVersions( 'string', {},)qlik ml experiment version ls \ --experimentId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/experiments/{experimentId}/versions" \-H "Authorization: Bearer <access_token>"Example Response
{ "data": [ { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "experiment-version", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "errors": "[{\"code\":\"AML-145\",\"title\":\"datasync dependent service error, service profile\",\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\",\"meta\":{\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\"}}]\n", "status": "pending", "target": "TargetColumn", "pipeline": { "transforms": [ { "column": { "name": "string", "changeType": "string" } } ] }, "createdAt": "string", "dataSetId": "672e55cfcadfb8a18281523e", "profileId": "string", "updatedAt": "string", "algorithms": [ "catboost_classifier" ], "topModelId": "string", "dateIndexes": [ "string" ], "errorMessage": "string", "experimentId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "featuresList": [ { "name": "ColumnA", "include": true, "dataType": "STRING", "changeType": null, "featureType": "categorical", "parentFeature": null } ], "lastBatchNum": 42, "datasetOrigin": "new", "versionNumber": 42, "experimentMode": "intelligent", "experimentType": "binary", "createdByUserId": "string", "trainingDuration": 900, "maxTrainingDuration": 900, "preprocessedInsights": [ { "name": "string", "insights": [], "willBeDropped": true } ] } } ], "meta": { "count": 42 }, "links": { "last": { "href": "string" }, "next": { "href": "string" }, "prev": { "href": "string" }, "self": { "href": "string" }, "first": { "href": "string" } }}Creates an experiment version.
Poll this version and check its status field to determine when models
are finished training.
Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- experimentId stringRequired
ID of the experiment
Request Body
- application/json object
Input for creating a new experiment version. Defaults provided in the ProfileInsights response.
application/json properties
- data objectRequired
data properties
- type stringRequired
Can be one of: "experiment-version"
- attributes objectRequired
attributes properties
- name stringRequired
- target stringRequired
The target field in the dataset. Set in first experiment version and can't be changed in subsequent versions.
- pipeline object
Pipeline metadata including transformations to apply to columns and specific schema configuration data
pipeline properties
- transforms array of objects
transforms properties
- column object
column properties
- name stringRequired
- changeType stringRequired
-
-
-
- dataSetId stringRequired
The Qlik catalog dataset ID
- algorithms array of strings
Algorithms used for model training in this version. See documentation for valid algorithms for each
experimentType.If not provided, defaults to all valid algorithms for your experimentType.
Values may be any of: "catboost_classifier""catboost_regression""elasticnet_regression""gaussian_nb""kneighbors_classifier""lasso_regression""lasso""lgbm_classifier""lgbm_regression""linear_regression""logistic_regression""random_forest_classifier""random_forest_regression""sgd_regression""xgb_classifier""xgb_regression"
- dateIndexes array of strings
A optional date column name to index
- featuresList array of objectsRequired
List of features from your dataset for creating Experiment Versions. This appears in from ProfileInsights response (in the defaultVersionConfig). You can adjust the default settings before using it as input to create or update Experiment Versions.
featuresList properties
- name string
Name of the feature column
- include boolean
Include this feature in your experiment version? Default here is based on insights for this feature (e.g. willBeDropped).
- dataType string
The data type of this feature in your dataset
Can be one of: "DATE""TIME""DATETIME""TIMESTAMP""STRING""DOUBLE""DECIMAL""INTEGER""BOOLEAN""BINARY""CUSTOM""FLOAT""OBJECT"
- changeType string
Indicates if you want to change the featureType for this feature within the experiment version
Can be one of: "categorical""numeric""date""freetext"
- featureType string
The default feature type based on the feature's data type. If you want a value to be interpreted differently (e.g. 0/1 as categorical/boolean instead of numeric), use
changeType.Can be one of: "categorical""numeric""date""freetext"
- parentFeature string
The parent feature name for engineered features. e.g.
OrderDatemay be the parent of its engineered features (features extracted from parent) likeOrderDate.YEAR,OrderDate.MONTH, etc.
-
- datasetOrigin string
Whether this is a new or other dataset
Can be one of: "new""changed""refreshed""same"
- experimentMode stringRequired
The model training mode for the experiment version
Can be one of: "intelligent""manual""manual_hpo"
- experimentType stringRequired
Experiment type
Can be one of: "binary""multiclass""regression"
- trainingDuration integer
Maximum allowed training duration in seconds, not elapsed training time. maxTrainingDuration takes precedence over trainingDuration when both are provided. If neither field is provided, the maximum for the experiment type is used. Accepted ranges:
- min 900 (15m), max 21600 (6h)
- maxTrainingDuration integer
Maximum allowed training duration in seconds, not elapsed training time. maxTrainingDuration takes precedence over trainingDuration when both are provided. If neither field is provided, the maximum for the experiment type is used. Accepted ranges:
- min 900 (15m), max 21600 (6h)
-
-
-
Responses
201
Accepted
- application/json object
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "experiment-version"
- attributes objectRequired
An AutoML experiment version. This is a configuration for training models within an experiment.
attributes properties
- id stringRequired Filterable
ID of this entity
- name string
Name of this entity
- errors array of objects
JSON string with list of error objects
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- status stringRequired Filterable
Current status of this entity
Can be one of: "ready""error""cancelled""pending""dataprep_requested""datasync_requested""datasync_done"
- target stringRequired
The target field in the dataset
- pipeline object
Pipeline metadata including transformations to apply to columns and specific schema configuration data
pipeline properties
- transforms array of objects
transforms properties
- column object
column properties
- name stringRequired
- changeType stringRequired
-
-
-
- createdAt stringRequired
Timestamp when this was created
- dataSetId stringRequired
The Qlik catalog dataset ID
- profileId string
ID of the dataset profile with metadata about source data
- updatedAt stringRequired
Timestamp when this was updated
- algorithms array of strings
List of algorithms selected for model training in this version
Values may be any of: "catboost_classifier""catboost_regression""elasticnet_regression""gaussian_nb""kneighbors_classifier""lasso_regression""lasso""lgbm_classifier""lgbm_regression""linear_regression""logistic_regression""random_forest_classifier""random_forest_regression""sgd_regression""xgb_classifier""xgb_regression"
- topModelId string
ID of the top model (based on training scores) in this experiment version
- dateIndexes array of strings
A optional date column name to index
- errorMessage string
JSON string of error object
- experimentId stringRequired
ID of the experiment
- featuresList array of objects
List of features from your dataset for creating Experiment Versions. This appears in from ProfileInsights response (in the defaultVersionConfig). You can adjust the default settings before using it as input to create or update Experiment Versions.
featuresList properties
- name string
Name of the feature column
- include boolean
Include this feature in your experiment version? Default here is based on insights for this feature (e.g. willBeDropped).
- dataType string
The data type of this feature in your dataset
Can be one of: "DATE""TIME""DATETIME""TIMESTAMP""STRING""DOUBLE""DECIMAL""INTEGER""BOOLEAN""BINARY""CUSTOM""FLOAT""OBJECT"
- changeType string
Indicates if you want to change the featureType for this feature within the experiment version
Can be one of: "categorical""numeric""date""freetext"
- featureType string
The default feature type based on the feature's data type. If you want a value to be interpreted differently (e.g. 0/1 as categorical/boolean instead of numeric), use
changeType.Can be one of: "categorical""numeric""date""freetext"
- parentFeature string
The parent feature name for engineered features. e.g.
OrderDatemay be the parent of its engineered features (features extracted from parent) likeOrderDate.YEAR,OrderDate.MONTH, etc.
-
- lastBatchNum integer
Number of the last batch
- datasetOrigin string
Whether this is a new or other dataset
Can be one of: "new""changed""refreshed""same"
- versionNumber integer
- -based sequential version number within the experiment
- experimentMode string
The model training mode for the experiment version
Can be one of: "intelligent""manual""manual_hpo"
- experimentType stringRequired
Experiment type
Can be one of: "binary""multiclass""regression"
- createdByUserId stringRequired Filterable
ID of owner/user for this entity
- trainingDuration integer
Maximum allowed training duration in seconds, not elapsed training time.
- maxTrainingDuration integer
Maximum allowed training duration in seconds, not elapsed training time.
- preprocessedInsights array of objects
Preprocessed insights. Like feature insights but with fewer details.
preprocessedInsights properties
- name stringRequired
Name of the preprocessed insight column
- insights array of stringsRequired
Preliminary list of column/feature insights available after preprocessing but before feature insights are available
Values may be any of: "is_free_text""cannot_be_processed_as_free_text""is_date_engineered""has_target_leakage""feature_type_change_invalid""feature_type_change_failed""feature_type_change_successful""data_bias_detected""representation_bias_detected"
- willBeDropped booleanRequired
Whether this feature insight will be dropped due to free text or high cardinality that makes it less useful
-
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.createMlExperimentVersion( 'string', { data: { attributes: { algorithms: ['catboost_classifier'], dataSetId: '672e55cfcadfb8a18281523e', datasetOrigin: 'new', dateIndexes: ['string'], experimentMode: 'intelligent', experimentType: 'binary', featuresList: [ { dataType: 'STRING', featureType: 'categorical', include: true, name: 'ColumnA', }, ], name: 'Experiment version name. Defaults to current date.', pipeline: { transforms: [ { column: { changeType: 'string', name: 'string', }, }, ], }, target: 'TargetColumn', trainingDuration: 900, }, type: 'experiment-version', }, },)qlik ml experiment version create \ --experimentId 'string' \ --data-attributes-algorithms 'catboost_classifier' \ --data-attributes-dataSetId '672e55cfcadfb8a18281523e' \ --data-attributes-datasetOrigin 'new' \ --data-attributes-dateIndexes 'string' \ --data-attributes-experimentMode 'intelligent' \ --data-attributes-experimentType 'binary' \ --data-attributes-featuresList-changeType '' \ --data-attributes-featuresList-dataType '' \ --data-attributes-featuresList-featureType '' \ --data-attributes-featuresList-include \ --data-attributes-featuresList-name '' \ --data-attributes-featuresList-parentFeature '' \ --data-attributes-name 'Experiment version name. Defaults to current date.' \ --data-attributes-pipeline-transforms-column-changeType '' \ --data-attributes-pipeline-transforms-column-name '' \ --data-attributes-target 'TargetColumn' \ --data-attributes-trainingDuration 900 \ --data-type 'experiment-version'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/experiments/{experimentId}/versions" \-X POST \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '{"data":{"type":"experiment-version","attributes":{"name":"Experiment version name. Defaults to current date.","target":"TargetColumn","pipeline":{"transforms":[{"column":{"name":"string","changeType":"string"}}]},"dataSetId":"672e55cfcadfb8a18281523e","algorithms":["catboost_classifier"],"dateIndexes":["string"],"featuresList":[{"name":"ColumnA","include":true,"dataType":"STRING","changeType":null,"featureType":"categorical","parentFeature":null}],"datasetOrigin":"new","experimentMode":"intelligent","experimentType":"binary","trainingDuration":900,"maxTrainingDuration":900}}}'Example Response
{ "data": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "experiment-version", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "errors": "[{\"code\":\"AML-145\",\"title\":\"datasync dependent service error, service profile\",\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\",\"meta\":{\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\"}}]\n", "status": "pending", "target": "TargetColumn", "pipeline": { "transforms": [ { "column": { "name": "string", "changeType": "string" } } ] }, "createdAt": "string", "dataSetId": "672e55cfcadfb8a18281523e", "profileId": "string", "updatedAt": "string", "algorithms": [ "catboost_classifier" ], "topModelId": "string", "dateIndexes": [ "string" ], "errorMessage": "string", "experimentId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "featuresList": [ { "name": "ColumnA", "include": true, "dataType": "STRING", "changeType": null, "featureType": "categorical", "parentFeature": null } ], "lastBatchNum": 42, "datasetOrigin": "new", "versionNumber": 42, "experimentMode": "intelligent", "experimentType": "binary", "createdByUserId": "string", "trainingDuration": 900, "maxTrainingDuration": 900, "preprocessedInsights": [ { "name": "string", "insights": [], "willBeDropped": true } ] } }}Facts
| Rate limit | Tier 1 (1000 requests per minute) |
Path Parameters
- experimentId stringRequired
ID of the experiment
- experimentVersionId stringRequired
ID of the experiment version
Responses
200
OK
- application/json object
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "experiment-version"
- attributes objectRequired
An AutoML experiment version. This is a configuration for training models within an experiment.
attributes properties
- id stringRequired Filterable
ID of this entity
- name string
Name of this entity
- errors array of objects
JSON string with list of error objects
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- status stringRequired Filterable
Current status of this entity
Can be one of: "ready""error""cancelled""pending""dataprep_requested""datasync_requested""datasync_done"
- target stringRequired
The target field in the dataset
- pipeline object
Pipeline metadata including transformations to apply to columns and specific schema configuration data
pipeline properties
- transforms array of objects
transforms properties
- column object
column properties
- name stringRequired
- changeType stringRequired
-
-
-
- createdAt stringRequired
Timestamp when this was created
- dataSetId stringRequired
The Qlik catalog dataset ID
- profileId string
ID of the dataset profile with metadata about source data
- updatedAt stringRequired
Timestamp when this was updated
- algorithms array of strings
List of algorithms selected for model training in this version
Values may be any of: "catboost_classifier""catboost_regression""elasticnet_regression""gaussian_nb""kneighbors_classifier""lasso_regression""lasso""lgbm_classifier""lgbm_regression""linear_regression""logistic_regression""random_forest_classifier""random_forest_regression""sgd_regression""xgb_classifier""xgb_regression"
- topModelId string
ID of the top model (based on training scores) in this experiment version
- dateIndexes array of strings
A optional date column name to index
- errorMessage string
JSON string of error object
- experimentId stringRequired
ID of the experiment
- featuresList array of objects
List of features from your dataset for creating Experiment Versions. This appears in from ProfileInsights response (in the defaultVersionConfig). You can adjust the default settings before using it as input to create or update Experiment Versions.
featuresList properties
- name string
Name of the feature column
- include boolean
Include this feature in your experiment version? Default here is based on insights for this feature (e.g. willBeDropped).
- dataType string
The data type of this feature in your dataset
Can be one of: "DATE""TIME""DATETIME""TIMESTAMP""STRING""DOUBLE""DECIMAL""INTEGER""BOOLEAN""BINARY""CUSTOM""FLOAT""OBJECT"
- changeType string
Indicates if you want to change the featureType for this feature within the experiment version
Can be one of: "categorical""numeric""date""freetext"
- featureType string
The default feature type based on the feature's data type. If you want a value to be interpreted differently (e.g. 0/1 as categorical/boolean instead of numeric), use
changeType.Can be one of: "categorical""numeric""date""freetext"
- parentFeature string
The parent feature name for engineered features. e.g.
OrderDatemay be the parent of its engineered features (features extracted from parent) likeOrderDate.YEAR,OrderDate.MONTH, etc.
-
- lastBatchNum integer
Number of the last batch
- datasetOrigin string
Whether this is a new or other dataset
Can be one of: "new""changed""refreshed""same"
- versionNumber integer
- -based sequential version number within the experiment
- experimentMode string
The model training mode for the experiment version
Can be one of: "intelligent""manual""manual_hpo"
- experimentType stringRequired
Experiment type
Can be one of: "binary""multiclass""regression"
- createdByUserId stringRequired Filterable
ID of owner/user for this entity
- trainingDuration integer
Maximum allowed training duration in seconds, not elapsed training time.
- maxTrainingDuration integer
Maximum allowed training duration in seconds, not elapsed training time.
- preprocessedInsights array of objects
Preprocessed insights. Like feature insights but with fewer details.
preprocessedInsights properties
- name stringRequired
Name of the preprocessed insight column
- insights array of stringsRequired
Preliminary list of column/feature insights available after preprocessing but before feature insights are available
Values may be any of: "is_free_text""cannot_be_processed_as_free_text""is_date_engineered""has_target_leakage""feature_type_change_invalid""feature_type_change_failed""feature_type_change_successful""data_bias_detected""representation_bias_detected"
- willBeDropped booleanRequired
Whether this feature insight will be dropped due to free text or high cardinality that makes it less useful
-
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.getMlExperimentVersion( 'string', 'string',)qlik ml experiment version get 'string' \ --experimentId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/experiments/{experimentId}/versions/{experimentVersionId}" \-H "Authorization: Bearer <access_token>"Example Response
{ "data": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "experiment-version", "attributes": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "name": "string", "errors": "[{\"code\":\"AML-145\",\"title\":\"datasync dependent service error, service profile\",\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\",\"meta\":{\"errorId\":\"c1546687-ad5d-4002-87f6-8c9711298db1\"}}]\n", "status": "pending", "target": "TargetColumn", "pipeline": { "transforms": [ { "column": { "name": "string", "changeType": "string" } } ] }, "createdAt": "string", "dataSetId": "672e55cfcadfb8a18281523e", "profileId": "string", "updatedAt": "string", "algorithms": [ "catboost_classifier" ], "topModelId": "string", "dateIndexes": [ "string" ], "errorMessage": "string", "experimentId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "featuresList": [ { "name": "ColumnA", "include": true, "dataType": "STRING", "changeType": null, "featureType": "categorical", "parentFeature": null } ], "lastBatchNum": 42, "datasetOrigin": "new", "versionNumber": 42, "experimentMode": "intelligent", "experimentType": "binary", "createdByUserId": "string", "trainingDuration": 900, "maxTrainingDuration": 900, "preprocessedInsights": [ { "name": "string", "insights": [], "willBeDropped": true } ] } }}Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- experimentId stringRequired
ID of the experiment
- experimentVersionId stringRequired
ID of the experiment version
Request Body
- application/json array of objects
Values that can be patched.
application/json properties
- op stringRequired
All patch requests use the replace operation
Can be one of: "replace"
- path stringRequired
Path for the properties you can update.
Can be one of: "/name"
- value anyRequired
Use for fields that can be
anytype (string, number, etc.)
-
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.patchMlExperimentVersion( 'string', 'string', [ { op: 'replace', path: '/name', value: 'New name', }, ],)qlik ml experiment version patch 'string' \ --experimentId 'string' \ --op 'replace' \ --path '/name' \ --value New namecurl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/experiments/{experimentId}/versions/{experimentVersionId}" \-X PATCH \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '[{"op":"replace","path":"/name","value":"New name"}]'Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- experimentId stringRequired
ID of the experiment
- experimentVersionId stringRequired
ID of the experiment version
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.deleteMlExperimentVersion( 'string', 'string',)qlik ml experiment version rm 'string' \ --experimentId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/experiments/{experimentId}/versions/{experimentVersionId}" \-X DELETE \-H "Authorization: Bearer <access_token>"Cancels jobs for an experiment version or batch prediction.
Facts
| Rate limit | Tier 2 (100 requests per minute) |
Path Parameters
- corrType stringRequired
The type of a resource paired with a corrId
Can be one of: "batch-prediction""experiment-version"
- corrId stringRequired
The ID of a correlated resource of corrType
Responses
204
No Content
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
405
Method Not Allowed
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.cancelMlJob( 'batch-prediction', 'string',)qlik ml cancel-job \ --corrType 'batch-prediction' \ --jobId 'string'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/jobs/{corrType}/{corrId}/actions/cancel" \-X POST \-H "Authorization: Bearer <access_token>"Starts creating profile insights for an experiment dataset.
This is an asynchronous operation. A 202 Accepted response indicates
that the process has started successfully. Use the link in the response
to check the status.
Facts
| Rate limit | Tier 2 (100 requests per minute) |
Request Body
- application/json object
Input to get dataset and feature metadata needed to create experiment versions
application/json properties
- data object
Data wrapper for request input
data properties
- type string
Can be one of: "profile-insights"
- attributes object
The request body for this resource
attributes properties
- target string
Optional selected target provided on subsequent requests
- include string
Fields to include in the response.
Currently only supported value is
dataSetProfile.When
dataSetProfileis specified, the response includes the full dataset profile.Can be one of: "dataSetProfile"
- dataSetId string
The Qlik catalog dataset ID
- shouldWait boolean
Whether the server should or client should manage polling/waiting
- experimentType string
Experiment type
Can be one of: "binary""multiclass""regression"
-
-
-
Responses
200
OK
- application/json object
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "profile-insights"
- attributes objectRequired
Insights (metadata) about an experiment dataset
attributes properties
- status stringRequired
Status of profile insights. Not available until
ready.Can be one of: "pending""error""ready"
- ownerId stringRequired Filterable
ID of owner/user for this entity
- insights array of objects
List of feature insights object, one per feature in the dataset
insights properties
- name stringRequired
Name of the feature insight
- insights array of stringsRequired
List of insights about this feature.
Values may be any of: "constant""high_cardinality""high_cardinality_integer""too_many_nulls""will_be_impact_encoded""will_be_one_hot_encoded""possible_free_text_encoded""valid_index""underrepresented_class""invalid_column_name""will_be_date_engineered"
- willBeDropped booleanRequired
Whether this feature will be dropped. Traits like high cardinality make some features less predictive or too costly to merit use.
- cannotBeTarget booleanRequired
Whether a feature cannot be the target field
- experimentTypes array of stringsRequired
Experiment types in this feature insight
Values may be any of: "binary""multiclass""regression"
- defaultFeatureType string
The default feature type based on the feature's data type. If you want a value to be interpreted differently (e.g. 0/1 as categorical/boolean instead of numeric), use
changeType.Can be one of: "categorical""numeric""date""freetext"
- engineeredFeatures array of strings
Preliminary list of engineered features as strings. If subsequent processing validates them, they'll be converted to EngineeredFeature objects within a NestedColumn, each of which may contain its own FeatureInsights.
- estimatedMaxForecastHorizon integer
Only applies for time series experiment types. This intial estimate of the combined max forecast window and gap (aka - horizon). It only applies to possible date index columns. After the experiment version is created, we get a more precise number for subsequent versions. When training data is grouped, this estimate may be less accurate.
-
- tenantId stringRequired Filterable
Tenant ID for this entity
- algorithms array of strings
List of algorithms available for the selected experiment type
Values may be any of: "catboost_classifier""catboost_regression""elasticnet_regression""gaussian_nb""kneighbors_classifier""lasso_regression""lasso""lgbm_classifier""lgbm_regression""linear_regression""logistic_regression""random_forest_classifier""random_forest_regression""sgd_regression""xgb_classifier""xgb_regression"
- isLargeCsv boolean
Is this a CSV dataset > 1GB?
- sizeInBytes integer
Size of the profiled dataset in bytes.
- numberOfRows number
Number of rows in the dataset.
When isLargeCsv is true, this is an estimate since their metadata is based on a sample rather than the full dataset.
For datasets over 1GB, multiply
rows(this) bycolumns(features included in experiment version) to calculate totalcellsto ensure it stays under your license limit. Large CSVs have a hard 100. M cell limit. - dataSetProfile object
Full dataset profile from the Profile Service.
dataSetProfile properties
- meta objectRequired
Metadata about a dataset profile computation.
meta properties
- status stringRequired
Can be one of: "FINISHED""PARTIAL""QUEUED""RUNNING""STALE""CANCELLED""FAILED""INCOMPLETE""DEFERRED"
- messages array of strings
- dataSetId stringRequired
The Qlik catalog dataset ID
- resultType string
Can be one of: "NORMAL""BASIC""BASIC_TOO_LARGE"
- connectionId string
- lastLoadTime string
- maxSizeBytes number
- computationEndTime string
- computationStartTime string
-
- samples array of objects
Sample values from a table/dataset.
samples properties
- name string
- records array of objects
A single record of sample values.
records properties
- values array of strings
-
- fieldNames array of strings
-
- profiles array of objects
Profile metadata for a single table/dataset.
profiles properties
- name stringRequired
- sizeInBytes number
- numberOfRows integerRequired
- fieldProfiles array of objectsRequired
Profile metadata for a single field/column.
fieldProfiles properties
- name string
- tags array of strings
- index integer
- median number
- average number
- dataType string
- kurtosis number
- skewness number
- fractiles array of numbers
- sampleValues array of strings
- technicalName string
- classification object
Classification metadata for a field.
classification properties
- pii boolean
- tags array of objects
A classification tag with a confidence score.
tags properties
- tag string
- score number
-
- sensitive boolean
- obfuscation string
-
- nullValueCount integer
- textValueCount integer
- zeroValueCount integer
- maxNumericValue number
- maxStringLength integer
- minNumericValue number
- minStringLength integer
- sumStringLength integer
- emptyStringCount integer
- sumNumericValues number
- numericValueCount integer
- standardDeviation number
- distinctValueCount integer
- mostFrequentValues array of objects
A value and its frequency count.
mostFrequentValues properties
- value string
- frequency number
-
- negativeValueCount integer
- positiveValueCount integer
- averageStringLength number
- frequencyDistribution array of objects
A frequency bin in a field's frequency distribution.
frequencyDistribution properties
- binEdge number
- frequency number
-
- lastSortedStringValue string
- firstSortedStringValue string
- sumSquaredNumericValues number
-
-
-
- experimentVersionId string
Optional experiment version ID. When included, it indicates that this dataset profile is a snapshot from a previous version.
- defaultVersionConfig object
Default configuration for creating an experiment version from this dataset. Not returned when
experimentVersionIdis provided.defaultVersionConfig properties
- name stringRequired
- dataSetId stringRequired
The Qlik catalog dataset ID
- featuresList array of objects
List of features from your dataset for creating Experiment Versions. This appears in from ProfileInsights response (in the defaultVersionConfig). You can adjust the default settings before using it as input to create or update Experiment Versions.
featuresList properties
- name string
Name of the feature column
- include boolean
Include this feature in your experiment version? Default here is based on insights for this feature (e.g. willBeDropped).
- dataType string
The data type of this feature in your dataset
Can be one of: "DATE""TIME""DATETIME""TIMESTAMP""STRING""DOUBLE""DECIMAL""INTEGER""BOOLEAN""BINARY""CUSTOM""FLOAT""OBJECT"
- changeType string
Indicates if you want to change the featureType for this feature within the experiment version
Can be one of: "categorical""numeric""date""freetext"
- featureType string
The default feature type based on the feature's data type. If you want a value to be interpreted differently (e.g. 0/1 as categorical/boolean instead of numeric), use
changeType.Can be one of: "categorical""numeric""date""freetext"
- parentFeature string
The parent feature name for engineered features. e.g.
OrderDatemay be the parent of its engineered features (features extracted from parent) likeOrderDate.YEAR,OrderDate.MONTH, etc.
-
- datasetOrigin stringRequired
Whether this is a new or other dataset
Can be one of: "new""changed""refreshed""same"
- experimentMode stringRequired
The model training mode for the experiment version
Can be one of: "intelligent""manual""manual_hpo"
-
-
-
-
202
Accepted
- application/json object
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "profile-insights"
- attributes objectRequired
Insights (metadata) about an experiment dataset
attributes properties
- status stringRequired
Status of profile insights. Not available until
ready.Can be one of: "pending""error""ready"
- ownerId stringRequired Filterable
ID of owner/user for this entity
- insights array of objects
List of feature insights object, one per feature in the dataset
insights properties
- name stringRequired
Name of the feature insight
- insights array of stringsRequired
List of insights about this feature.
Values may be any of: "constant""high_cardinality""high_cardinality_integer""too_many_nulls""will_be_impact_encoded""will_be_one_hot_encoded""possible_free_text_encoded""valid_index""underrepresented_class""invalid_column_name""will_be_date_engineered"
- willBeDropped booleanRequired
Whether this feature will be dropped. Traits like high cardinality make some features less predictive or too costly to merit use.
- cannotBeTarget booleanRequired
Whether a feature cannot be the target field
- experimentTypes array of stringsRequired
Experiment types in this feature insight
Values may be any of: "binary""multiclass""regression"
- defaultFeatureType string
The default feature type based on the feature's data type. If you want a value to be interpreted differently (e.g. 0/1 as categorical/boolean instead of numeric), use
changeType.Can be one of: "categorical""numeric""date""freetext"
- engineeredFeatures array of strings
Preliminary list of engineered features as strings. If subsequent processing validates them, they'll be converted to EngineeredFeature objects within a NestedColumn, each of which may contain its own FeatureInsights.
- estimatedMaxForecastHorizon integer
Only applies for time series experiment types. This intial estimate of the combined max forecast window and gap (aka - horizon). It only applies to possible date index columns. After the experiment version is created, we get a more precise number for subsequent versions. When training data is grouped, this estimate may be less accurate.
-
- tenantId stringRequired Filterable
Tenant ID for this entity
- algorithms array of strings
List of algorithms available for the selected experiment type
Values may be any of: "catboost_classifier""catboost_regression""elasticnet_regression""gaussian_nb""kneighbors_classifier""lasso_regression""lasso""lgbm_classifier""lgbm_regression""linear_regression""logistic_regression""random_forest_classifier""random_forest_regression""sgd_regression""xgb_classifier""xgb_regression"
- isLargeCsv boolean
Is this a CSV dataset > 1GB?
- sizeInBytes integer
Size of the profiled dataset in bytes.
- numberOfRows number
Number of rows in the dataset.
When isLargeCsv is true, this is an estimate since their metadata is based on a sample rather than the full dataset.
For datasets over 1GB, multiply
rows(this) bycolumns(features included in experiment version) to calculate totalcellsto ensure it stays under your license limit. Large CSVs have a hard 100. M cell limit. - dataSetProfile object
Full dataset profile from the Profile Service.
dataSetProfile properties
- meta objectRequired
Metadata about a dataset profile computation.
meta properties
- status stringRequired
Can be one of: "FINISHED""PARTIAL""QUEUED""RUNNING""STALE""CANCELLED""FAILED""INCOMPLETE""DEFERRED"
- messages array of strings
- dataSetId stringRequired
The Qlik catalog dataset ID
- resultType string
Can be one of: "NORMAL""BASIC""BASIC_TOO_LARGE"
- connectionId string
- lastLoadTime string
- maxSizeBytes number
- computationEndTime string
- computationStartTime string
-
- samples array of objects
Sample values from a table/dataset.
samples properties
- name string
- records array of objects
A single record of sample values.
records properties
- values array of strings
-
- fieldNames array of strings
-
- profiles array of objects
Profile metadata for a single table/dataset.
profiles properties
- name stringRequired
- sizeInBytes number
- numberOfRows integerRequired
- fieldProfiles array of objectsRequired
Profile metadata for a single field/column.
fieldProfiles properties
- name string
- tags array of strings
- index integer
- median number
- average number
- dataType string
- kurtosis number
- skewness number
- fractiles array of numbers
- sampleValues array of strings
- technicalName string
- classification object
Classification metadata for a field.
classification properties
- pii boolean
- tags array of objects
A classification tag with a confidence score.
tags properties
- tag string
- score number
-
- sensitive boolean
- obfuscation string
-
- nullValueCount integer
- textValueCount integer
- zeroValueCount integer
- maxNumericValue number
- maxStringLength integer
- minNumericValue number
- minStringLength integer
- sumStringLength integer
- emptyStringCount integer
- sumNumericValues number
- numericValueCount integer
- standardDeviation number
- distinctValueCount integer
- mostFrequentValues array of objects
A value and its frequency count.
mostFrequentValues properties
- value string
- frequency number
-
- negativeValueCount integer
- positiveValueCount integer
- averageStringLength number
- frequencyDistribution array of objects
A frequency bin in a field's frequency distribution.
frequencyDistribution properties
- binEdge number
- frequency number
-
- lastSortedStringValue string
- firstSortedStringValue string
- sumSquaredNumericValues number
-
-
-
- experimentVersionId string
Optional experiment version ID. When included, it indicates that this dataset profile is a snapshot from a previous version.
- defaultVersionConfig object
Default configuration for creating an experiment version from this dataset. Not returned when
experimentVersionIdis provided.defaultVersionConfig properties
- name stringRequired
- dataSetId stringRequired
The Qlik catalog dataset ID
- featuresList array of objects
List of features from your dataset for creating Experiment Versions. This appears in from ProfileInsights response (in the defaultVersionConfig). You can adjust the default settings before using it as input to create or update Experiment Versions.
featuresList properties
- name string
Name of the feature column
- include boolean
Include this feature in your experiment version? Default here is based on insights for this feature (e.g. willBeDropped).
- dataType string
The data type of this feature in your dataset
Can be one of: "DATE""TIME""DATETIME""TIMESTAMP""STRING""DOUBLE""DECIMAL""INTEGER""BOOLEAN""BINARY""CUSTOM""FLOAT""OBJECT"
- changeType string
Indicates if you want to change the featureType for this feature within the experiment version
Can be one of: "categorical""numeric""date""freetext"
- featureType string
The default feature type based on the feature's data type. If you want a value to be interpreted differently (e.g. 0/1 as categorical/boolean instead of numeric), use
changeType.Can be one of: "categorical""numeric""date""freetext"
- parentFeature string
The parent feature name for engineered features. e.g.
OrderDatemay be the parent of its engineered features (features extracted from parent) likeOrderDate.YEAR,OrderDate.MONTH, etc.
-
- datasetOrigin stringRequired
Whether this is a new or other dataset
Can be one of: "new""changed""refreshed""same"
- experimentMode stringRequired
The model training mode for the experiment version
Can be one of: "intelligent""manual""manual_hpo"
-
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.createMlProfileInsight({ data: { attributes: { dataSetId: '672e55cfcadfb8a18281523e', experimentType: 'binary', include: 'dataSetProfile', target: 'string', }, type: 'profile-insights', },})qlik ml profile-insight createcurl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/profile-insights" \-X POST \-H "Content-type: application/json" \-H "Authorization: Bearer <access_token>" \-d '{"data":{"type":"profile-insights","attributes":{"target":"string","include":"dataSetProfile","dataSetId":"672e55cfcadfb8a18281523e","shouldWait":false,"experimentType":"binary"}}}'Example Response
{ "data": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "profile-insights", "attributes": { "status": "pending", "ownerId": "string", "insights": [ { "name": "string", "insights": [ "constant" ], "willBeDropped": true, "cannotBeTarget": true, "experimentTypes": [ "binary" ], "defaultFeatureType": "categorical", "engineeredFeatures": "[\n `${featureName}.YEAR`,\n `${featureName}.MONTH`\n]\n", "estimatedMaxForecastHorizon": 42 } ], "tenantId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "algorithms": [ "catboost_classifier" ], "isLargeCsv": true, "sizeInBytes": 42, "numberOfRows": 42, "dataSetProfile": { "meta": { "status": "FINISHED", "messages": [ "string" ], "dataSetId": "672e55cfcadfb8a18281523e", "resultType": "NORMAL", "connectionId": "string", "lastLoadTime": "string", "maxSizeBytes": 42, "computationEndTime": "string", "computationStartTime": "string" }, "samples": [ { "name": "string", "records": [ { "values": [ "string" ] } ], "fieldNames": [ "string" ] } ], "profiles": [ { "name": "string", "sizeInBytes": 42, "numberOfRows": 42, "fieldProfiles": [ { "name": "string", "tags": [ "string" ], "index": 42, "median": 42, "average": 42, "dataType": "string", "kurtosis": 42, "skewness": 42, "fractiles": [ 42 ], "sampleValues": [ "string" ], "technicalName": "string", "classification": { "pii": true, "tags": [ { "tag": "string", "score": 42 } ], "sensitive": true, "obfuscation": "string" }, "nullValueCount": 42, "textValueCount": 42, "zeroValueCount": 42, "maxNumericValue": 42, "maxStringLength": 42, "minNumericValue": 42, "minStringLength": 42, "sumStringLength": 42, "emptyStringCount": 42, "sumNumericValues": 42, "numericValueCount": 42, "standardDeviation": 42, "distinctValueCount": 42, "mostFrequentValues": [ { "value": "string", "frequency": 42 } ], "negativeValueCount": 42, "positiveValueCount": 42, "averageStringLength": 42, "frequencyDistribution": [ { "binEdge": 42, "frequency": 42 } ], "lastSortedStringValue": "string", "firstSortedStringValue": "string", "sumSquaredNumericValues": 42 } ] } ] }, "experimentVersionId": "string", "defaultVersionConfig": { "name": "Experiment version name. Defaults to current date/time.", "dataSetId": "672e55cfcadfb8a18281523e", "featuresList": [ { "name": "ColumnA", "include": true, "dataType": "STRING", "changeType": null, "featureType": "categorical", "parentFeature": null } ], "datasetOrigin": "new", "experimentMode": "intelligent" } } }}Retrieves profile insights for the specified dataset. If you received a
202 Accepted response from POST /ml/profile-insights, poll this
endpoint until a 200 OK response with ready status is returned.
Facts
| Rate limit | Tier 1 (1000 requests per minute) |
Query Parameters
- experimentVersionId string
The optional experimentVersionId query parameter for profile-insights GET requests. When provided after a version has been trained, it gets the profile insights snapshot used in previous versions rather than new results.
- target string
The optional target feature for profile-insights GET requests after this is known.
- experimentType string
The optional experiment type for profile-insights GET requests after this is known.
Can be one of: "binary""multiclass""regression"
Path Parameters
- dataSetId stringRequired
The Qlik catalog dataset ID
Responses
200
OK
- application/json object
application/json properties
- data objectRequired
data properties
- id stringRequired Filterable
ID of this entity
- type stringRequired
Can be one of: "profile-insights"
- attributes objectRequired
Insights (metadata) about an experiment dataset
attributes properties
- status stringRequired
Status of profile insights. Not available until
ready.Can be one of: "pending""error""ready"
- ownerId stringRequired Filterable
ID of owner/user for this entity
- insights array of objects
List of feature insights object, one per feature in the dataset
insights properties
- name stringRequired
Name of the feature insight
- insights array of stringsRequired
List of insights about this feature.
Values may be any of: "constant""high_cardinality""high_cardinality_integer""too_many_nulls""will_be_impact_encoded""will_be_one_hot_encoded""possible_free_text_encoded""valid_index""underrepresented_class""invalid_column_name""will_be_date_engineered"
- willBeDropped booleanRequired
Whether this feature will be dropped. Traits like high cardinality make some features less predictive or too costly to merit use.
- cannotBeTarget booleanRequired
Whether a feature cannot be the target field
- experimentTypes array of stringsRequired
Experiment types in this feature insight
Values may be any of: "binary""multiclass""regression"
- defaultFeatureType string
The default feature type based on the feature's data type. If you want a value to be interpreted differently (e.g. 0/1 as categorical/boolean instead of numeric), use
changeType.Can be one of: "categorical""numeric""date""freetext"
- engineeredFeatures array of strings
Preliminary list of engineered features as strings. If subsequent processing validates them, they'll be converted to EngineeredFeature objects within a NestedColumn, each of which may contain its own FeatureInsights.
- estimatedMaxForecastHorizon integer
Only applies for time series experiment types. This intial estimate of the combined max forecast window and gap (aka - horizon). It only applies to possible date index columns. After the experiment version is created, we get a more precise number for subsequent versions. When training data is grouped, this estimate may be less accurate.
-
- tenantId stringRequired Filterable
Tenant ID for this entity
- algorithms array of strings
List of algorithms available for the selected experiment type
Values may be any of: "catboost_classifier""catboost_regression""elasticnet_regression""gaussian_nb""kneighbors_classifier""lasso_regression""lasso""lgbm_classifier""lgbm_regression""linear_regression""logistic_regression""random_forest_classifier""random_forest_regression""sgd_regression""xgb_classifier""xgb_regression"
- isLargeCsv boolean
Is this a CSV dataset > 1GB?
- sizeInBytes integer
Size of the profiled dataset in bytes.
- numberOfRows number
Number of rows in the dataset.
When isLargeCsv is true, this is an estimate since their metadata is based on a sample rather than the full dataset.
For datasets over 1GB, multiply
rows(this) bycolumns(features included in experiment version) to calculate totalcellsto ensure it stays under your license limit. Large CSVs have a hard 100. M cell limit. - dataSetProfile object
Full dataset profile from the Profile Service.
dataSetProfile properties
- meta objectRequired
Metadata about a dataset profile computation.
meta properties
- status stringRequired
Can be one of: "FINISHED""PARTIAL""QUEUED""RUNNING""STALE""CANCELLED""FAILED""INCOMPLETE""DEFERRED"
- messages array of strings
- dataSetId stringRequired
The Qlik catalog dataset ID
- resultType string
Can be one of: "NORMAL""BASIC""BASIC_TOO_LARGE"
- connectionId string
- lastLoadTime string
- maxSizeBytes number
- computationEndTime string
- computationStartTime string
-
- samples array of objects
Sample values from a table/dataset.
samples properties
- name string
- records array of objects
A single record of sample values.
records properties
- values array of strings
-
- fieldNames array of strings
-
- profiles array of objects
Profile metadata for a single table/dataset.
profiles properties
- name stringRequired
- sizeInBytes number
- numberOfRows integerRequired
- fieldProfiles array of objectsRequired
Profile metadata for a single field/column.
fieldProfiles properties
- name string
- tags array of strings
- index integer
- median number
- average number
- dataType string
- kurtosis number
- skewness number
- fractiles array of numbers
- sampleValues array of strings
- technicalName string
- classification object
Classification metadata for a field.
classification properties
- pii boolean
- tags array of objects
A classification tag with a confidence score.
tags properties
- tag string
- score number
-
- sensitive boolean
- obfuscation string
-
- nullValueCount integer
- textValueCount integer
- zeroValueCount integer
- maxNumericValue number
- maxStringLength integer
- minNumericValue number
- minStringLength integer
- sumStringLength integer
- emptyStringCount integer
- sumNumericValues number
- numericValueCount integer
- standardDeviation number
- distinctValueCount integer
- mostFrequentValues array of objects
A value and its frequency count.
mostFrequentValues properties
- value string
- frequency number
-
- negativeValueCount integer
- positiveValueCount integer
- averageStringLength number
- frequencyDistribution array of objects
A frequency bin in a field's frequency distribution.
frequencyDistribution properties
- binEdge number
- frequency number
-
- lastSortedStringValue string
- firstSortedStringValue string
- sumSquaredNumericValues number
-
-
-
- experimentVersionId string
Optional experiment version ID. When included, it indicates that this dataset profile is a snapshot from a previous version.
- defaultVersionConfig object
Default configuration for creating an experiment version from this dataset. Not returned when
experimentVersionIdis provided.defaultVersionConfig properties
- name stringRequired
- dataSetId stringRequired
The Qlik catalog dataset ID
- featuresList array of objects
List of features from your dataset for creating Experiment Versions. This appears in from ProfileInsights response (in the defaultVersionConfig). You can adjust the default settings before using it as input to create or update Experiment Versions.
featuresList properties
- name string
Name of the feature column
- include boolean
Include this feature in your experiment version? Default here is based on insights for this feature (e.g. willBeDropped).
- dataType string
The data type of this feature in your dataset
Can be one of: "DATE""TIME""DATETIME""TIMESTAMP""STRING""DOUBLE""DECIMAL""INTEGER""BOOLEAN""BINARY""CUSTOM""FLOAT""OBJECT"
- changeType string
Indicates if you want to change the featureType for this feature within the experiment version
Can be one of: "categorical""numeric""date""freetext"
- featureType string
The default feature type based on the feature's data type. If you want a value to be interpreted differently (e.g. 0/1 as categorical/boolean instead of numeric), use
changeType.Can be one of: "categorical""numeric""date""freetext"
- parentFeature string
The parent feature name for engineered features. e.g.
OrderDatemay be the parent of its engineered features (features extracted from parent) likeOrderDate.YEAR,OrderDate.MONTH, etc.
-
- datasetOrigin stringRequired
Whether this is a new or other dataset
Can be one of: "new""changed""refreshed""same"
- experimentMode stringRequired
The model training mode for the experiment version
Can be one of: "intelligent""manual""manual_hpo"
-
-
-
-
400
Bad Request
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
401
Unauthorized
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
403
Forbidden
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
404
Not Found
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
500
Internal Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
502
Bad Gateway
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
503
Service Unavailable
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
default
Unexpected Error
- application/json object
application/json properties
- errors array of objectsRequired
An error object
errors properties
- code stringRequired
Qlik error code (not HTTP response status code)
- meta object
Additional details about the error. These may vary by error.
meta properties
- issue string
The issue code
- details string
Extra details for what may have caused the error
- errorId string
The unique id of the error instance
- argument string
The argument
- resource string
The resource type that the error occurred on
- resourceId string
The resource id that the error occurred on
-
- title stringRequired
Short summary of error
- detail string
Description of the error
-
- traceId string
-
import { createQlikApi } from '@qlik/api'
const qlik = createQlikApi({ hostConfig: { host: 'https://{tenant}.{region}.qlikcloud.com', apiKey: '<access-token>', },})
await qlik.ml.getMlProfileInsight( '672e55cfcadfb8a18281523e',)qlik ml profile-insight get '672e55cfcadfb8a18281523e'curl "https://{tenant}.{region}.qlikcloud.com/api/v1/ml/profile-insights/{dataSetId}" \-H "Authorization: Bearer <access_token>"Example Response
{ "data": { "id": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "type": "profile-insights", "attributes": { "status": "pending", "ownerId": "string", "insights": [ { "name": "string", "insights": [ "constant" ], "willBeDropped": true, "cannotBeTarget": true, "experimentTypes": [ "binary" ], "defaultFeatureType": "categorical", "engineeredFeatures": "[\n `${featureName}.YEAR`,\n `${featureName}.MONTH`\n]\n", "estimatedMaxForecastHorizon": 42 } ], "tenantId": "c35f4b70-3ce4-4a30-b62b-2aef16943bc4", "algorithms": [ "catboost_classifier" ], "isLargeCsv": true, "sizeInBytes": 42, "numberOfRows": 42, "dataSetProfile": { "meta": { "status": "FINISHED", "messages": [ "string" ], "dataSetId": "672e55cfcadfb8a18281523e", "resultType": "NORMAL", "connectionId": "string", "lastLoadTime": "string", "maxSizeBytes": 42, "computationEndTime": "string", "computationStartTime": "string" }, "samples": [ { "name": "string", "records": [ { "values": [ "string" ] } ], "fieldNames": [ "string" ] } ], "profiles": [ { "name": "string", "sizeInBytes": 42, "numberOfRows": 42, "fieldProfiles": [ { "name": "string", "tags": [ "string" ], "index": 42, "median": 42, "average": 42, "dataType": "string", "kurtosis": 42, "skewness": 42, "fractiles": [ 42 ], "sampleValues": [ "string" ], "technicalName": "string", "classification": { "pii": true, "tags": [ { "tag": "string", "score": 42 } ], "sensitive": true, "obfuscation": "string" }, "nullValueCount": 42, "textValueCount": 42, "zeroValueCount": 42, "maxNumericValue": 42, "maxStringLength": 42, "minNumericValue": 42, "minStringLength": 42, "sumStringLength": 42, "emptyStringCount": 42, "sumNumericValues": 42, "numericValueCount": 42, "standardDeviation": 42, "distinctValueCount": 42, "mostFrequentValues": [ { "value": "string", "frequency": 42 } ], "negativeValueCount": 42, "positiveValueCount": 42, "averageStringLength": 42, "frequencyDistribution": [ { "binEdge": 42, "frequency": 42 } ], "lastSortedStringValue": "string", "firstSortedStringValue": "string", "sumSquaredNumericValues": 42 } ] } ] }, "experimentVersionId": "string", "defaultVersionConfig": { "name": "Experiment version name. Defaults to current date/time.", "dataSetId": "672e55cfcadfb8a18281523e", "featuresList": [ { "name": "ColumnA", "include": true, "dataType": "STRING", "changeType": null, "featureType": "categorical", "parentFeature": null } ], "datasetOrigin": "new", "experimentMode": "intelligent" } } }}