Model REST API Guide

List models

get

Get list of model for provided query and filters

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
latest_onlybooleanOptional

Whether to send only latest version of each model or all version. False by default

project_idstring · uuidOptional

project id query parameter

filterstringOptional

Allows you to filter by any field.

searchstringOptional

Allows you to search by any field.

orderingstringOptional

Allows you to order results by any field. For desc order prefix field name with - and provide comman separated values for multiple fields

limitintegerOptional

Limit for the pagination

offsetintegerOptional

Offset for the pagination

Responses
200

List of models for provided query and filters

application/json
Responseall of
get
/v3/models

Add a new model under a project

post

Add a new model under a project

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
namestringRequired

Name of the model

versionstring · min: 1 · max: 64Optional

Version of the model

Default: v1
project_idstring · uuidRequired

UUID format unique identifier for the project the model is added in

statusstring · enumOptionalDefault: LIVEPossible values:
input_typestring · enumRequired

Enumeration of different model input types.

Possible values:
taskstring · enumRequired

Enumeration of different types of model tasks.

Possible values:
descriptionstring | nullableOptional

Description of the model

owner_idstring | nullableOptional

User ID for the owner of the model

deployment_datestring · date-time | nullableOptional

Date the model was deployed on

algorithmstring | nullableOptional

Model algorithm

frameworkstring | nullableOptional

A string providing information about the software library and version used to train and run this model

event_id_colstring | nullableOptional

Event id column to be found in published data for the model

event_ts_colstring | nullableOptional

Timestamp column to be found in published data for the model

event_ts_formatstring | nullableOptional

Format of the timestamp like datetime, epoch time etc.

Responses
200

Created model JSON response

application/json
Responseall of
post
/v3/models

Get details of a model

get

Details of a model for given model id

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
model_idstring · uuidRequired

model id path parameter

Responses
200

Model JSON response for provided model id

application/json
Responseall of
get
/v3/models/{model_id}

Delete a model

delete

Delete a model

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
model_idstring · uuidRequired

model id path parameter

Responses
delete
/v3/models/{model_id}

Update the fields of a model

patch

Update the fields of a model

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
model_idstring · uuidRequired

model id path parameter

Body
statusstring · enumOptionalDefault: LIVEPossible values:
versionstring · min: 1 · max: 64Optional

Version of the model

Default: v1
input_typestring · enumOptional

Enumeration of different model input types.

Possible values:
taskstring · enumOptional

Enumeration of different types of model tasks.

Possible values:
descriptionstring | nullableOptional

Description of the model

owner_idstring | nullableOptional

User ID for the owner of the model

deployment_datestring · date-time | nullableOptional

Date the model was deployed on

algorithmstring | nullableOptional

Model algorithm

frameworkstring | nullableOptional

A string providing information about the software library and version used to train and run this model

event_id_colstring | nullableOptional

Event id column to be found in published data for the model

event_ts_colstring | nullableOptional

Timestamp column to be found in published data for the model

event_ts_formatstring | nullableOptional

Format of the timestamp like datetime, epoch time etc.

Responses
200

Updated model JSON response

application/json
Responseall of
patch
/v3/models/{model_id}

Generate model from the given data sample

post

Generate model from the given data sample

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
file_idstring · uuidRequired
max_cardinalityinteger · min: 1 · max: 100000OptionalDefault: 1000
sample_sizeinteger · min: 10000 · max: 100000OptionalDefault: 10000
Responses
200

Generated model

application/json
Responseall of
post
/v3/model-factory

Update artifacts associated with the model

put

Update artifacts associated with the model

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
model_idstring · uuidRequired

model id path parameter

Query parameters
Responses
200

Updated Model Artifacts

application/json
Responseall of
put
/v3/models/{model_id}/deploy-artifact

Upload artifacts associated with the model

post

Upload artifacts associated with the model

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
model_idstring · uuidRequired

model id path parameter

Query parameters
Responses
200

Deployed Model Artifacts

application/json
Responseall of
post
/v3/models/{model_id}/deploy-artifact

Update a surrogate model

put

Update a surrogate model

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
model_idstring · uuidRequired

model id path parameter

Body
anyOptional
Responses
put
/v3/models/{model_id}/deploy-surrogate

Deploy a surrogate model

post

Deploy a surrogate model

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
model_idstring · uuidRequired

model id path parameter

Body
anyOptional
Responses
post
/v3/models/{model_id}/deploy-surrogate

Details of all columns

get

Details of all columns for a model

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
model_idstring · uuidRequired

model id path parameter

Responses
200

Details of all columns for a model

application/json
Responseall of
get
/v3/models/{model_id}/columns
get

Details of a specific column for a model

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
model_idstring · uuidRequired

model id path parameter

column_idstringRequired

column_id path parameter

Responses
200

Details of a specific column for a model

application/json
Responseall of
get
/v3/models/{model_id}/columns/{column_id}

Last updated

Was this helpful?