The Model Monitoring API gives you programmatic access to the Model Monitor.
To invoke these APIs, you must pass the API token in the header. See API Token for more information.
Domino Model Monitoring can only ingest prediction data for Model APIs in the form of Domino Datasets captured using Domino’s prediction capture library. To ingest different data types, create a new model in Domino Model Monitor and use a Model Monitor Data Source.
DatasetJob
getDatasetTimeline
/v2/api/model/{model_id}/dataset-timeline
Gets the dataset ingestion timeline
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | string | path | |||
start_date | number | query | |||
end_date | number | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | Gets the dataset ingestion timeline | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 500 | Internal server error, check server logs. |
DataSource
deleteDataSource
/v2/api/datasource
Create or delete a datasource.
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
datasource_id | string | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | The data source object that was deleted. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
Model
getPredictionTraffic
/v2/api/model/get-prediction-traffic
Gets the model prediction traffic
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_ids | string | query | |||
start_date | number | query | |||
end_date | number | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | Gets the model prediction traffic | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 500 | Internal server error, check server logs. |
getGroundTruthTraffic
/v2/api/model/{model_id}/traffic/ground-truth
Gets the model's ground truth traffic for matched labels
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | string | path | |||
startTimestamp | number | query | |||
endTimestamp | number | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | Gets the ground truth traffic based on number of ground truth labels that matched prediction data. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Model not found. | |
| 500 | Internal server error, check server logs. |
registerDatasetConfig
/v2/api/model/{model_id}/register-dataset/{dataset_type}
Dataset registration to a model.
| Code | Message | Datatype |
|---|---|---|
| 200 | Successfully registered dataset to the Model. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
getModelById
/v2/api/model
Gets a DMM model either via a unique model identifier or via a unique combination of workbench model id and workbench model version id
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | string | query | |||
workbench_model_version_id | string | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | Successfully fetched the Model. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Model not found. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
updateModelById
/v2/api/model
Update one or more editable attributes of a DMM model.
| Code | Message | Datatype |
|---|---|---|
| 200 | Successfully updated the model. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Model not found. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
deleteModelById
/v2/api/model
Model Operations.
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | string | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | Successfully deleted the Model. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Model not found. | |
| 405 | Method not allowed. | |
| 409 | Conflict with model requested. | |
| 500 | Internal server error, check server logs. |
listModels
/v2/api/models
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
pageNumber | integer | query | |||
pageSize | integer | query | |||
numberOfLastChecksToFetch | integer | query | |||
searchQuery | string | query | |||
modelType | Undefined | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | Successfully fetched the Model. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
getModelSummary
/v2/api/get_model_summary
Gets a DMM model summary either via a unique model identifier or via a unique combination of workbench model id and workbench model version id
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | string | query | |||
workbench_model_version_id | string | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | Successfully fetched the Model summary. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Model not found. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
getModelVariablesSummary
/v2/api/model/{model_id}/variables/summary
Get the model's variables summary list
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | string | path |
| Code | Message | Datatype |
|---|---|---|
| 200 | Successfully fetched the Model. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Model not found. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
updateModelVisibility
/v2/api/model/{model_id}/visibility
Updates the visibility of a standalone DMM model
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | string | path | |||
visibility | Undefined | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | Successfully updated model visibility. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Model not found. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
getModelCollaborators
/v2/api/model/{model_id}/collaborators
Fetches all collaborators for a standalone DMM model
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | string | path |
| Code | Message | Datatype |
|---|---|---|
| 200 | Successfully fetched the model's collaborators. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Model not found. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
addCollaborators
/v2/api/model/{model_id}/collaborators
Adds collaborators to a standalone DMM model
| Code | Message | Datatype |
|---|---|---|
| 200 | Successfully add a collaborator to model. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Model not found. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
updateCollaboratorRole
/v2/api/model/{model_id}/collaborators
Updates an existing collaborator for a standalone DMM model
| Code | Message | Datatype |
|---|---|---|
| 200 | Successfully updated a model collaborator. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Model not found. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
deleteCollaborator
/v2/api/model/{model_id}/collaborators
Deletes an existing collaborator for a standalone DMM model
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | string | path | |||
collaborator_id | string | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | Successfully removed a collaborator from a model. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Model not found. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
ModelDrift
analyzeDrift
/v2/api/model/{model_id}/analyse-drift
Returns drift analysis for the model based on the user's config (or model's scheduler config). The endpoint is behind the old backend's auth mechanism.
| Code | Message | Datatype |
|---|---|---|
| 200 | The drift analyze query was done successfully. | |
| 204 | Empty response. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 500 | Internal server error, check server logs. |
getDriftUserQuery
/v2/api/model/{model_id}/drift-user-query
Returns drift scheduler config for the model. The endpoint is behind the old backend's auth mechanism.
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | Identifier for the model to be updated. | string | path |
| Code | Message | Datatype |
|---|---|---|
| 200 | The drift scheduler query was generated successfully. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 500 | Internal server error, check server logs. |
getDriftSchedulerQuery
/v2/api/model/{model_id}/drift-scheduler-query
Returns drift scheduler config for the model.
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | Identifier for the model to be updated. | string | path |
| Code | Message | Datatype |
|---|---|---|
| 200 | The drift scheduler query was generated successfully. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 500 | Internal server error, check server logs. |
getModelColumnDriftTrend
/v2/api/model/{model_id}/{column_id}/drift-trend
Returns drift trend for the model's column. The endpoint is behind the old backend's auth mechanism.
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | Identifier for the model for the trends | string | path | ||
column_id | Identifier for the column. | string | path | ||
startDate | Start time for the data used for the query. | number | query | ||
endDate | End time for the data used for the query. | number | query | ||
algorithm | Algorithm function used for the check query | string | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | The drift trend fetch query was done successfully. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 500 | Internal server error, check server logs. |
saveSchedulerQuery
/v2/api/model/{model_id}/save-scheduler-query
Saves drift scheduler config for the model. The endpoint is behind the old backend's auth mechanism.
| Code | Message | Datatype |
|---|---|---|
| 200 | The drift scheduler query was generated successfully. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 500 | Internal server error, check server logs. |
getDriftScheduleChecksHistory
/v2/api/model/{model_id}/drift-schedule-checks-history
Gets the model timeline data for drift schedule history page
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | string | path | |||
start_date | string | query | |||
end_date | string | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | Gets the model timeline data | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 500 | Internal server error, check server logs. |
getScheduledCheckDriftData
/v2/api/model/{model_id}/{scheduler_id}/scheduled-check-drift-data
Get scheduled check drift data
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | string | path | |||
scheduler_id | string | path | |||
sortOrder | string | query | |||
sortOn | string | query | |||
pageNumber | string | query | |||
pageSize | string | query | |||
searchQuery | string | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | Gets the model timeline data | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 500 | Internal server error, check server logs. |
ModelQuality
analyzeModelQuality
/v2/api/model/{model_id}/analyze-model-quality
Returns MQ analyze for the model based on the user's config (or model's default config).
| Code | Message | Datatype |
|---|---|---|
| 200 | The MQ analyze query was done successfully. | |
| 204 | Empty response. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 500 | Internal server error, check server logs. |
getModelQualityUserQuery
/v2/api/model/{model_id}/model-quality-user-query
Returns model quality user config for the model.
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | Identifier for the model. | string | path |
| Code | Message | Datatype |
|---|---|---|
| 200 | The model quality user query was fetched successfully. | |
| 204 | The model quality user query does not exist for the user. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 500 | Internal server error, check server logs. |
getModelQualityTrend
/v2/api/model/{model_id}/model-quality-trend
Returns model quality trend for the model for specific model quality metric.
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | Identifier of the model. | string | path | ||
startTimestamp | Start time for the data used for the query. | number | query | ||
endTimestamp | End time for the data used for the query. | number | query | ||
metricName | Metric used for the trend. | string | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | The model quality trend was fetched successfully. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 500 | Internal server error, check server logs. |
getModelQualitySchedulerQuery
/v2/api/model/{model_id}/model-quality-scheduler-query
Returns model quality scheduler query for the model.
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | Identifier for the model. | string | path |
| Code | Message | Datatype |
|---|---|---|
| 200 | The model quality scheduler query was fetched successfully. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Model Quality Scheduler Query not found. | |
| 500 | Internal server error, check server logs. |
saveModelQualitySchedulerQuery
/v2/api/model/{model_id}/model-quality-scheduler-query
Returns model quality scheduler query for the model.
| Code | Message | Datatype |
|---|---|---|
| 200 | The model quality scheduler query was saved successfully. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Model Quality Scheduler Query not found. | |
| 500 | Internal server error, check server logs. |
getModelQualityScheduledChecksTimeline
/v2/api/model/{model_id}/model-quality-scheduled-checks-history
Gets the model timeline data for model quality schedule history page
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | string | path | |||
start_date | string | query | |||
end_date | string | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | Gets the model timeline data | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Model not found or is deleted. | |
| 500 | Internal server error, check server logs. |
getModelQualityScheduledCheckData
/v2/api/model/{scheduled_check_id}/model-quality-scheduled-check-data
Gets the model scheduled check data for MQ schedule history page for the passed scheduled check id
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
scheduled_check_id | string | path |
| Code | Message | Datatype |
|---|---|---|
| 200 | Gets the scheduled check data | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Data for passed Scheduled Check Id not found. | |
| 500 | Internal server error, check server logs. |
Workbench
Get summary for workbench model versions
/v2/api/workbench/model/version/summary
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_version_ids | a string of comma separated workbench model version ids. | string | query | ||
start_date | number | query | |||
end_date | number | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | Model summaries were fetched successfully. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
DefaultSettings
Get drift default settings
/v2/api/setting/default/drift
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
is_active | Whether to fetch only the active drift default setting or not. | boolean | query |
| Code | Message | Datatype |
|---|---|---|
| 200 | Drift default settings fetched successfully. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
Get model quality metric default settings
/v2/api/setting/default/metric
| Code | Message | Datatype |
|---|---|---|
| 200 | Model Quality Metric default settings fetched successfully. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
Update the model quality metric default settings.
/v2/api/setting/default/metric
| Code | Message | Datatype |
|---|---|---|
| 200 | Model Quality Metric Default settings updated successfully. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
Notification
Fetch alert config for the given model.
/v2/api/notification/model-config/{model_id}
| Name | Description | Required | Type | In | Example |
|---|---|---|---|---|---|
model_id | string | path |
| Code | Message | Datatype |
|---|---|---|
| 200 | Model Alert Config was fetched successfully. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Model Alert Config not found for the given model id. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
Create or Update the existing model alert config.
/v2/api/notification/model-config/{model_id}
| Code | Message | Datatype |
|---|---|---|
| 200 | Model Alert Config was updated successfully. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
Fetch channel config for notifications in DMM.
/v2/api/notification/channel-config
| Code | Message | Datatype |
|---|---|---|
| 200 | Channel config fetched successfully. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 404 | Notification Channel config not found. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
Create or Update existing channel config for notifications in DMM.
/v2/api/notification/channel-config
| Code | Message | Datatype |
|---|---|---|
| 200 | Notification Channel Config was updated successfully. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
Other
getCurrentUser
/v2/api/auth/user/current
Get current user Information.
| Code | Message | Datatype |
|---|---|---|
| 200 | Successfully returned user information. | |
| 400 | Bad request input data. | |
| 401 | Unauthorized. The endpoint requires authentication. | |
| 403 | Forbidden. The endpoint enforces authorization. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
getApiKeyReport
/v2/api/auth/api_key_report
Get CSV report of active API keys with their corresponding users.
| Code | Message | Datatype |
|---|---|---|
| 200 | Successfully returned an API key report in CSV format. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 405 | Method not allowed. | |
| 500 | Internal server error, check server logs. |
getUserApiKey
/v2/api/auth/user/api_key
Gets current user's DMM API key.
| Code | Message | Datatype |
|---|---|---|
| 200 | Gets user DMM API key. | |
| 400 | Bad request input data. | |
| 403 | Forbidden. The endpoint enforces permissions. | |
| 405 | Method not allowed. | |
| 409 | Conflict with resource requested. | |
| 500 | Internal server error, check server logs. |