# Model APIs

String Length Limit

All properties, variables, and attributes that have a string data type cannot exceed a length of 64135 characters when part of a PUT, POST, or PATCH operation payload.

# GET Query Model Definitions

# /modelDefinitions

# Description

Filterable properties:
- modelId: string
- name: string
- tags: array[string]
- components: object

# Parameters

Name	Located in	Description	Required	Schema
filter	query	A boolean expression used to filter the results	No	WhereClause
limit	query	Limit the number of returned values. Defaults to 100 if not specified	No	LimitClause
includeDeleted	query	Whether to included model definitions that have been marked as deleted.	No	boolean

# Responses

Code	Description	Schema
200	A list of model definitions.	feedResponseModelDefinition
400	Invalid request. Response will contain details about all encountered validation errors - i.e. request payload too large, malformed JSON, etc	ServiceErrors
401	Not Authorized. Either the Access token is missing or the access token validation failed
403	Access Forbidden. Requesting entity does not have enough permissions to access the resource
429	Too many requests - indicates the user has sent too many requests in a given amount of time	ServiceErrors
500	Service error. Service has encountered one or more unexpected conditions that prevented it from fulfilling the request, which may or may not be temporary. Response will contain more details about these errors	ServiceErrors

# POST Create a Model Definition

# /modelDefinitions

# Description

Creates a new model definition based on the request payload. The model definition is defined by selecting components from the set of possible components the information model supports (properties, variables, methods, references, and attributes). The selection is done by adding them to the model definition. Additionally, shared elements can be defined such as properties that should have common semantics across all types within this model definition. A common property serves as an example. The semantics of the model definition that defines common elements are not required to be defined in the types; however, if they are defined they must conform to the definition.

# Responses

Code	Description	Schema
201	Creation succeeded.	modelDefinition
400	Invalid request. Response will contain details about all encountered validation errors - i.e. request payload too large, malformed JSON, etc	ServiceErrors
401	Not Authorized. Either the Access token is missing or the access token validation failed
403	Access Forbidden. Requesting entity does not have enough permissions to access the resource
429	Too many requests - indicates the user has sent too many requests in a given amount of time	ServiceErrors
500	Service error. Service has encountered one or more unexpected conditions that prevented it from fulfilling the request, which may or may not be temporary. Response will contain more details about these errors	ServiceErrors

# GET Retrieve Model Definition

# /modelDefinitions/{modelId}

# Description

Retrieves a model definition based on its modelId. By specifying the includeDeleted parameter, this can also be used to retrieve a model definition that has been marked as deleted.

# Parameters

Name	Located in	Description	Required	Schema
modelId	path	Model definition ID	Yes	string
includeDeleted	query	Whether to return a model definition that has been marked as deleted.	No	boolean

# Responses

Code	Description	Schema
200	Model definition	modelDefinition
400	Invalid request. Response will contain details about all encountered validation errors - i.e. request payload too large, malformed JSON, etc	ServiceErrors
401	Not Authorized. Either the Access token is missing or the access token validation failed
403	Access Forbidden. Requesting entity does not have enough permissions to access the resource
404	Model definition not found	ServiceErrors
429	Too many requests - indicates the user has sent too many requests in a given amount of time	ServiceErrors
500	Service error. Service has encountered one or more unexpected conditions that prevented it from fulfilling the request, which may or may not be temporary. Response will contain more details about these errors	ServiceErrors

# PUT Update a Model Definition

# /modelDefinitions/{modelId}

# Description

Updates a model definition based on its modelId. The model definition must be backwards compatible to the previous one. For example, no removal of components such as "variables" is allowed. The version attribute provided in the request must match the version on the server or the request will be rejected.

# Parameters

Name	Located in	Description	Required	Schema
modelId	path	Model definition ID	Yes	string

# Responses

Code	Description	Schema
200	Model definition.	modelDefinition
400	Invalid request. Response will contain details about all encountered validation errors - i.e. request payload too large, malformed JSON, etc	ServiceErrors
401	Not Authorized. Either the Access token is missing or the access token validation failed
403	Access Forbidden. Requesting entity does not have enough permissions to access the resource
404	Model definition not found	ServiceErrors
429	Too many requests - indicates the user has sent too many requests in a given amount of time	ServiceErrors
500	Service error. Service has encountered one or more unexpected conditions that prevented it from fulfilling the request, which may or may not be temporary. Response will contain more details about these errors	ServiceErrors

# DELETE Delete a Model Definition

# /modelDefinitions/{modelId}

# Description

This marks a model definition as deleted. No new types can be added to it. So far no cascading delete for the contained types will be done. The model definition will stay in the database and the modelId will stay reserved, as this is a soft delete. To delete the entity completely (hard delete), please contact the Operations Team.

# Parameters

Name	Located in	Description	Required	Schema
modelId	path	Model definition ID	Yes	string

# Responses

Code	Description	Schema
204	Model definition was successfully deleted
400	Invalid request. Response will contain details about all encountered validation errors - i.e. request payload too large, malformed JSON, etc	ServiceErrors
401	Not Authorized. Either the Access token is missing or the access token validation failed
403	Access Forbidden. Requesting entity does not have enough permissions to access the resource
404	Model definition was not found	ServiceErrors
429	Too many requests - indicates the user has sent too many requests in a given amount of time	ServiceErrors
500	Service error. Service has encountered one or more unexpected conditions that prevented it from fulfilling the request, which may or may not be temporary. Response will contain more details about these errors	ServiceErrors

# GET GET Query list of Groups

# /modelDefinitions/groups

# Description

Retrieves the list of groups and their corresponding counts for all existing Model Definitions.

Filterable properties:

model: string
group: string
status: string

# Parameters

Name	Located in	Description	Required	Schema
filter	query	A boolean expression used to filter the results	No	WhereClause
limit	query	Limit the number of returned values. Defaults to 100 if not specified	No	LimitClause
sort	query	Sorts the value based on SortColumn SortDirection eg: modelId desc	No	sortClause
page	query	Indicates page number. default value is set to 1.	No	integer
includeDeleted	query	Whether to included model definitions that have been marked as deleted.	No	boolean

# Responses

Code	Description	Schema
200	A list of groups	Groups
400	Invalid request. Response will contain details about all encountered validation errors - i.e. request payload too large, malformed JSON, etc	ServiceErrors
401	Not Authorized. Either the Access token is missing or the access token validation failed
403	Access Forbidden. Requesting entity does not have enough permissions to access the resource
404	Type definition not found	ServiceErrors
429	Too many requests - indicates the user has sent too many requests in a given amount of time	ServiceErrors
500	Service error. Service has encountered one or more unexpected conditions that prevented it from fulfilling the request, which may or may not be temporary. Response will contain more details about these errors	ServiceErrors

# GET GET Query list of modelIds

# /modelDefinitions/modellist

# Description

Retrieves list of model ids for all existing Model Definitions from database.

Filterable properties:

model: string

# Parameters

Name	Located in	Description	Required	Schema
filter	query	A boolean expression used to filter the results	No	WhereClause
limit	query	Limit the number of returned values. Defaults to 100 if not specified	No	LimitClause
sort	query	Sorts the value based on SortColumn SortDirection eg: modelId desc	No	sortClause
page	query	Indicates page number. default value is set to 1.	No	integer
includeDeleted	query	Whether to included model definitions that have been marked as deleted.	No	boolean

# Responses

Code	Description	Schema
200	A list of model Ids	modelDefinition
400	Invalid request. Response will contain details about all encountered validation errors - i.e. request payload too large, malformed JSON, etc	ServiceErrors
401	Not Authorized. Either the Access token is missing or the access token validation failed
403	Access Forbidden. Requesting entity does not have enough permissions to access the resource
404	Type definition not found	ServiceErrors
429	Too many requests - indicates the user has sent too many requests in a given amount of time	ServiceErrors
500	Service error. Service has encountered one or more unexpected conditions that prevented it from fulfilling the request, which may or may not be temporary. Response will contain more details about these errors	ServiceErrors

# GET GET Query Model Definitions with Workflow

# /modelDefinitions/workFlow

# Description

Gets model definitions from database with workflow information.

Filterable properties:

model: string
name: string
status: string
tags: array[string]
components: object

# Parameters

Name	Located in	Description	Required	Schema
filter	query	A boolean expression used to filter the results	No	WhereClause
limit	query	Limit the number of returned values. Defaults to 100 if not specified	No	LimitClause
sort	query	Sorts the value based on SortColumn SortDirection eg: modelId desc	No	sortClause
page	query	Indicates page number. default value is set to 1.	No	integer
includeDeleted	query	Whether to included model definitions that have been marked as deleted.	No	boolean

# Responses

Code	Description	Schema
200	A list of model definitions with workflow information	modelDefinition
400	Invalid request. Response will contain details about all encountered validation errors - i.e. request payload too large, malformed JSON, etc	ServiceErrors
401	Not Authorized. Either the Access token is missing or the access token validation failed
403	Access Forbidden. Requesting entity does not have enough permissions to access the resource
404	Type definition not found	ServiceErrors
429	Too many requests - indicates the user has sent too many requests in a given amount of time	ServiceErrors
500	Service error. Service has encountered one or more unexpected conditions that prevented it from fulfilling the request, which may or may not be temporary. Response will contain more details about these errors	ServiceErrors

# PUT Bulk Update model definitions

# /modelDefinitions/groupUpdate

# Description

Bulk Update multiple ModelDefinition based on given group.

# Parameters

Name	Located in	Description	Required	Schema
includeDeleted	query	Whether to included model definitions that have been marked as deleted.	No	boolean

# Responses

Code	Description	Schema
200	Model definition.	modelDefinition
400	Invalid request. Response will contain details about all encountered validation errors - i.e. request payload too large, malformed JSON, etc	ServiceErrors
401	Not Authorized. Either the Access token is missing or the access token validation failed
403	Access Forbidden. Requesting entity does not have enough permissions to access the resource
404	Model definition not found	ServiceErrors
429	Too many requests - indicates the user has sent too many requests in a given amount of time	ServiceErrors
500	Service error. Service has encountered one or more unexpected conditions that prevented it from fulfilling the request, which may or may not be temporary. Response will contain more details about these errors	ServiceErrors

← Properties Types →