Skip to content

アプリケーション内で をクリックすると、お使いのDataRobotバージョンに関する全プラットフォームドキュメントにアクセスできます。

Notifications

This page outlines the operations, endpoints, parameters, and example requests and responses for the Notifications.

GET /api/v2/notificationChannels/

List the notification channels according to the query.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/notificationChannels/?offset=0&limit=100 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
offset query integer true How many notification channels to skip.
limit query integer true At most this many notification channels to return.
namePart query string false Only return the notification channels whose names contain the given substring.

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "channelType": "Database",
      "contentType": "application/json",
      "createdAt": "2019-08-24T14:15:22Z",
      "customHeaders": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "emailAddress": "string",
      "id": "string",
      "languageCode": "en",
      "lastNotificationAt": "2019-08-24T14:15:22Z",
      "name": "string",
      "orgId": "string",
      "payloadUrl": "http://example.com",
      "policyCount": 0,
      "secretToken": "string",
      "uid": "string",
      "updatedAt": "2019-08-24T14:15:22Z",
      "validateSsl": true
    }
  ],
  "next": "string",
  "previous": "string",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK Notification channels listed successfully. NotificationChannelsListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/notificationChannels/

Create a new notification channel.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/notificationChannels/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "channelType": "Database",
  "contentType": "application/json",
  "customHeaders": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "emailAddress": "string",
  "languageCode": "en",
  "name": "string",
  "orgId": "string",
  "payloadUrl": "http://example.com",
  "secretToken": "string",
  "validateSsl": true,
  "verificationCode": "string"
}

Parameters

Name In Type Required Description
body body NotificationChannelCreate false none

Example responses

201 Response

{
  "channelType": "Database",
  "contentType": "application/json",
  "createdAt": "2019-08-24T14:15:22Z",
  "customHeaders": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "emailAddress": "string",
  "id": "string",
  "languageCode": "en",
  "lastNotificationAt": "2019-08-24T14:15:22Z",
  "name": "string",
  "orgId": "string",
  "payloadUrl": "http://example.com",
  "policyCount": 0,
  "secretToken": "string",
  "uid": "string",
  "updatedAt": "2019-08-24T14:15:22Z",
  "validateSsl": true
}

Responses

Status Meaning Description Schema
201 Created Notification channel created successfully. NotificationChannelResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

DELETE /api/v2/notificationChannels/{channelId}/

Delete the notification channel.

Code samples

# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/notificationChannels/{channelId}/ \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
channelId path string true The id of the notification channel.

Responses

Status Meaning Description Schema
204 No Content Notification channel deleted successfully. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/notificationChannels/{channelId}/

Retrieve the notification channel.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/notificationChannels/{channelId}/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
channelId path string true The id of the notification channel.

Example responses

200 Response

{
  "channelType": "Database",
  "contentType": "application/json",
  "createdAt": "2019-08-24T14:15:22Z",
  "customHeaders": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "emailAddress": "string",
  "id": "string",
  "languageCode": "en",
  "lastNotificationAt": "2019-08-24T14:15:22Z",
  "name": "string",
  "orgId": "string",
  "payloadUrl": "http://example.com",
  "policyCount": 0,
  "secretToken": "string",
  "uid": "string",
  "updatedAt": "2019-08-24T14:15:22Z",
  "validateSsl": true
}

Responses

Status Meaning Description Schema
200 OK Notification channel retrieved successfully. NotificationChannelResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

PUT /api/v2/notificationChannels/{channelId}/

Update the notification channel.

Code samples

# You can also use wget
curl -X PUT https://app.datarobot.com/api/v2/notificationChannels/{channelId}/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "contentType": "application/json",
  "customHeaders": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "emailAddress": "string",
  "languageCode": "en",
  "name": "string",
  "payloadUrl": "http://example.com",
  "secretToken": "string",
  "validateSsl": true,
  "verificationCode": "string"
}

Parameters

Name In Type Required Description
channelId path string true The id of the notification channel.
body body NotificationChannelUpdate false none

Responses

Status Meaning Description Schema
204 No Content Notification channel updated successfully. None
400 Bad Request Email verification code is invalid. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/notificationEmailChannelVerification/

Sending a 6 digit verification code to user's email

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/notificationEmailChannelVerification/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "channelType": "string",
  "emailAddress": "string",
  "name": "string",
  "orgId": "string"
}

Parameters

Name In Type Required Description
body body NotificationEmailChannelVerification false none

Example responses

200 Response

{
  "notificationId": "string"
}

Responses

Status Meaning Description Schema
200 OK none NotificationEmailChannelVerificationResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/notificationEmailChannelVerificationStatus/

Retrieve the status of whether admin enter code correctly

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/notificationEmailChannelVerificationStatus/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "emailAddress": "string",
  "verificationCode": "string"
}

Parameters

Name In Type Required Description
body body NotificationEmailChannelVerificationStatus false none

Example responses

200 Response

{
  "status": true
}

Responses

Status Meaning Description Schema
200 OK none NotificationEmailChannelVerificationStatusResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/notificationEvents/

List event types and groups the user can include in notification policies. Events and groups are filtered by user permissions and event properties. It is not a complete list of all defined events; instead, it is a list of the events available to the user.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/notificationEvents/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
relatedEntityType query string false Type of related entity.

Enumerated Values

Parameter Value
relatedEntityType [deployment, Deployment, DEPLOYMENT]

Example responses

200 Response

{
  "eventGroups": [
    {
      "events": [
        "string"
      ],
      "id": "string",
      "label": "string"
    }
  ],
  "events": [
    {
      "id": "string",
      "label": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Event types and groups selectable for notification policies NotificationEventListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/notificationLogs/

List the notification logs that correspond to provided conditions. Default ordering is desc by notification log timestamp

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/notificationLogs/?offset=0&limit=100 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
offset query integer true The number of records to skip over. Default 0
limit query integer true The number of records to return. Default to 100, minimum to 1, maximum to 1000
policyId query string false The id of the policy to filter notification logs
channelId query string false The id of the channel to filter notification logs

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "channelId": "string",
      "channelScope": "organization",
      "emailSubject": "string",
      "id": "string",
      "parentNotificationId": "string",
      "policyId": "string",
      "request": {
        "body": "string",
        "headers": "string",
        "url": "http://example.com"
      },
      "response": {
        "body": "string",
        "duration": 0,
        "headers": "string",
        "statusCode": "string"
      },
      "retryCount": 0,
      "status": "string",
      "timestamp": "2019-08-24T14:15:22Z"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK none NotificationLogListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/notificationPolicies/

List the notification policies that satisfy the query condition.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/notificationPolicies/?offset=0&limit=100 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
offset query integer true How many notification channels to skip.
limit query integer true At most this many notification channels to return.
channelId query string false Return policies with this channel.
namePart query string false Only return the notification channels whose names contain the given substring.
eventGroup query string false Return policies with this event group.

Enumerated Values

Parameter Value
eventGroup [secure_config.all, comment.all, dataset.all, deployment_prediction_explanations_computation.all, model_deployments.critical_health, model_deployments.critical_frequent_health_change, model_deployments.frequent_health_change, model_deployments.health, inference_endpoints.health, model_deployments.management_agent, model_deployments.management_agent_health, prediction_request.all, challenger_management.all, challenger_replay.all, model_deployments.all, project.all, perma_delete_project.all, users_delete.all, applications.all, batch_predictions.all, change_requests.all, insights_computation.all, notebook_schedule.all, monitoring.all]

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "active": true,
      "channel": {
        "channelType": "Database",
        "contentType": "application/json",
        "createdAt": "2019-08-24T14:15:22Z",
        "customHeaders": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "emailAddress": "string",
        "id": "string",
        "languageCode": "en",
        "name": "string",
        "orgId": "string",
        "payloadUrl": "http://example.com",
        "secretToken": "string",
        "uid": "string",
        "updatedAt": "2019-08-24T14:15:22Z",
        "validateSsl": true
      },
      "channelId": "string",
      "created": "2019-08-24T14:15:22Z",
      "eventGroup": {
        "events": [
          {
            "id": "string",
            "label": "string"
          }
        ],
        "id": "string",
        "label": "string"
      },
      "eventType": {
        "id": "string",
        "label": "string"
      },
      "id": "string",
      "lastTriggered": "2019-08-24T14:15:22Z",
      "name": "string",
      "orgId": "string",
      "uid": "string",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "next": "string",
  "previous": "string",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK Notification policies listed successfully. NotificationPoliciesListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/notificationPolicies/

Create a new notification policy.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/notificationPolicies/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "active": true,
  "channelId": "string",
  "eventGroup": "secure_config.all",
  "eventType": "secure_config.created",
  "name": "string",
  "orgId": "string"
}

Parameters

Name In Type Required Description
body body NotificationPolicyCreate false none

Example responses

201 Response

{
  "active": true,
  "channel": {
    "channelType": "Database",
    "contentType": "application/json",
    "createdAt": "2019-08-24T14:15:22Z",
    "customHeaders": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "emailAddress": "string",
    "id": "string",
    "languageCode": "en",
    "name": "string",
    "orgId": "string",
    "payloadUrl": "http://example.com",
    "secretToken": "string",
    "uid": "string",
    "updatedAt": "2019-08-24T14:15:22Z",
    "validateSsl": true
  },
  "channelId": "string",
  "created": "2019-08-24T14:15:22Z",
  "eventGroup": {
    "events": [
      {
        "id": "string",
        "label": "string"
      }
    ],
    "id": "string",
    "label": "string"
  },
  "eventType": {
    "id": "string",
    "label": "string"
  },
  "id": "string",
  "lastTriggered": "2019-08-24T14:15:22Z",
  "name": "string",
  "orgId": "string",
  "uid": "string",
  "updatedAt": "2019-08-24T14:15:22Z"
}

Responses

Status Meaning Description Schema
201 Created Notification policy created successfully. NotificationPolicyResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

DELETE /api/v2/notificationPolicies/{policyId}/

Delete the notification policy.

Code samples

# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/notificationPolicies/{policyId}/ \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
policyId path string true The id of the notification policy

Responses

Status Meaning Description Schema
204 No Content Notification policy deleted successfully. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/notificationPolicies/{policyId}/

Retrieve the notification policy.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/notificationPolicies/{policyId}/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
policyId path string true The id of the notification policy

Example responses

200 Response

{
  "active": true,
  "channel": {
    "channelType": "Database",
    "contentType": "application/json",
    "createdAt": "2019-08-24T14:15:22Z",
    "customHeaders": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "emailAddress": "string",
    "id": "string",
    "languageCode": "en",
    "name": "string",
    "orgId": "string",
    "payloadUrl": "http://example.com",
    "secretToken": "string",
    "uid": "string",
    "updatedAt": "2019-08-24T14:15:22Z",
    "validateSsl": true
  },
  "channelId": "string",
  "created": "2019-08-24T14:15:22Z",
  "eventGroup": {
    "events": [
      {
        "id": "string",
        "label": "string"
      }
    ],
    "id": "string",
    "label": "string"
  },
  "eventType": {
    "id": "string",
    "label": "string"
  },
  "id": "string",
  "lastTriggered": "2019-08-24T14:15:22Z",
  "name": "string",
  "orgId": "string",
  "uid": "string",
  "updatedAt": "2019-08-24T14:15:22Z"
}

Responses

Status Meaning Description Schema
200 OK Notification policy retrieved successfully. NotificationPolicyResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

PUT /api/v2/notificationPolicies/{policyId}/

Update the notification policy.

Code samples

# You can also use wget
curl -X PUT https://app.datarobot.com/api/v2/notificationPolicies/{policyId}/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "active": true,
  "channelId": "string",
  "eventGroup": "secure_config.all",
  "eventType": "secure_config.created",
  "name": "string"
}

Parameters

Name In Type Required Description
policyId path string true The id of the notification policy
body body NotificationPolicyUpdate false none

Responses

Status Meaning Description Schema
204 No Content Notification policy updated successfully. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/notificationPolicyMutes/

List the ignored notifications filtered by orgId if provided

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/notificationPolicyMutes/?offset=0&limit=100 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
offset query integer true The number of records to skip over. Default 0
limit query integer true The number of records to return. Default to 100, minimum to 1, maximum to 1000
entityId query string false The id of the entity to filter
orgId query string false The id of the organization that ignored notifications relate to

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "entityId": "string",
      "id": "string",
      "policyId": "string",
      "uid": "string"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK none NotificationPolicyMuteListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/notificationPolicyMutes/

Create a new ignored notification

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/notificationPolicyMutes/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "entityId": "string",
  "policyId": "string"
}

Parameters

Name In Type Required Description
body body NotificationPolicyMuteCreate false none

Example responses

200 Response

{
  "entityId": "string",
  "id": "string",
  "policyId": "string",
  "uid": "string"
}

Responses

Status Meaning Description Schema
200 OK none NotificationPolicyMuteResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

DELETE /api/v2/notificationPolicyMutes/{muteId}/

Delete the existing notification policy mute

Code samples

# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/notificationPolicyMutes/{muteId}/ \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
muteId path string true The id of the notification policy mute to delete

Responses

Status Meaning Description Schema
200 OK none None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/notificationWebhookChannelTests/

Test the webhook notification channel.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/notificationWebhookChannelTests/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "channelType": "Database",
  "contentType": "application/json",
  "customHeaders": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "emailAddress": "string",
  "name": "string",
  "orgId": "string",
  "payloadUrl": "http://example.com",
  "secretToken": "string",
  "validateSsl": true
}

Parameters

Name In Type Required Description
body body NotificationWebhookChannelTestCreate false none

Example responses

201 Response

{
  "notificationId": "string"
}

Responses

Status Meaning Description Schema
201 Created The test for the webhook notification channel was created. NotificationWebhookChannelTestId

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/notificationWebhookChannelTests/{notificationId}/

Retrieve the status of the notification channel test.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/notificationWebhookChannelTests/{notificationId}/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
notificationId path string true The identifier of the notification.

Example responses

200 Response

{
  "notificationLog": {
    "channelId": "string",
    "channelScope": "organization",
    "emailSubject": "string",
    "id": "string",
    "parentNotificationId": "string",
    "policyId": "string",
    "request": "string",
    "response": "string",
    "retryCount": 0,
    "status": "string",
    "timestamp": "2019-08-24T14:15:22Z"
  },
  "status": "string"
}

Responses

Status Meaning Description Schema
200 OK The notification status was retrieved. NotificationWebhookChannelStatusResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/notifications/

Resends the notification

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/notifications/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "notificationId": "string"
}

Parameters

Name In Type Required Description
body body NotificationResend false none

Responses

Status Meaning Description Schema
200 OK none None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

POST /api/v2/remoteEvents/

Post an event from a remote deployment.

Code samples

# You can also use wget
curl -X POST https://app.datarobot.com/api/v2/remoteEvents/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Body parameter

{
  "data": {
    "newModelId": "string",
    "oldModelId": "string",
    "reason": "string"
  },
  "deploymentId": "string",
  "eventType": "deploymentInfo",
  "externalNanPredictionsData": {
    "count": 0,
    "modelId": null
  },
  "message": "string",
  "orgId": "string",
  "predictionEnvironmentId": "string",
  "predictionRequestData": {
    "error_code": "string",
    "model_id": "string",
    "response_body": "string",
    "status_code": 0,
    "user_id": "string"
  },
  "spoolerChannelData": {
    "name": "string",
    "type": "asyncMemory"
  },
  "timestamp": "2019-08-24T14:15:22Z",
  "title": "string"
}

Parameters

Name In Type Required Description
body body RemoteEventCreate false none

Example responses

201 Response

{
  "message": "string"
}

Responses

Status Meaning Description Schema
201 Created The event was created. CreateRemoteEventResponse
404 Not Found The deployment was not found. None
422 Unprocessable Entity Unable to process the request instructions or failed to post the event. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

DELETE /api/v2/userNotifications/

Delete all notifications associated with the user.

Code samples

# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/userNotifications/ \
  -H "Authorization: Bearer {access-token}"

Responses

Status Meaning Description Schema
204 No Content Notifications were deleted. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

GET /api/v2/userNotifications/

Returns list of user's notifications from latest to oldest.

Code samples

# You can also use wget
curl -X GET https://app.datarobot.com/api/v2/userNotifications/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
offset query integer false The number of records to skip over
limit query integer false The number of records to return
isRead query boolean false When provided, returns only read or unread notifications

Example responses

200 Response

{
  "count": 0,
  "data": [
    {
      "callerUser": {
        "fullName": "string",
        "gravatarHash": "string",
        "inactive": true,
        "uid": "string",
        "username": "string"
      },
      "created": "2019-08-24T14:15:22Z",
      "description": "string",
      "eventType": "autopilot.complete",
      "isRead": true,
      "link": "string",
      "pushNotificationSent": true,
      "relatedComment": {
        "commentId": "string",
        "commentLink": "string",
        "entityId": "string",
        "entityType": "useCase",
        "inactive": true
      },
      "relatedDeployment": {
        "deploymentId": "string",
        "deploymentName": "string",
        "deploymentUrl": "string",
        "inactive": true,
        "modelId": "string",
        "projectId": "string",
        "userId": "string"
      },
      "relatedProject": {
        "inactive": true,
        "pid": "string",
        "projectLink": "string",
        "projectName": "string"
      },
      "relatedSecureConfig": {
        "secureConfigLink": "string",
        "secureConfigName": "string",
        "secureConfigSchemaName": "string",
        "secureConfigSchemaUuid": "string",
        "secureConfigUuid": "string"
      },
      "relatedUsersDelete": {
        "reportId": "string",
        "statusId": "string",
        "usersToDeleteCount": "string"
      },
      "sharedUsers": [
        {
          "fullName": "string",
          "gravatarHash": "string",
          "inactive": true,
          "uid": "string",
          "username": "string"
        }
      ],
      "statusId": "string",
      "title": "string",
      "tooltip": "string",
      "updated": "2019-08-24T14:15:22Z",
      "userNotificationId": "string"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Responses

Status Meaning Description Schema
200 OK A paginated list of notifications. UserNotificationListResponse

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

PATCH /api/v2/userNotifications/

Mark all associated notifications with the user as read.

Code samples

# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/userNotifications/ \
  -H "Authorization: Bearer {access-token}"

Responses

Status Meaning Description Schema
204 No Content All notification were marked as read. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

DELETE /api/v2/userNotifications/{userNotificationId}/

Delete one notification associated with the user.

Code samples

# You can also use wget
curl -X DELETE https://app.datarobot.com/api/v2/userNotifications/{userNotificationId}/ \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
userNotificationId path string true Unique identifier of the notification.

Responses

Status Meaning Description Schema
204 No Content Notification was deleted. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

PATCH /api/v2/userNotifications/{userNotificationId}/

Mark one associated notification with the user as read.

Code samples

# You can also use wget
curl -X PATCH https://app.datarobot.com/api/v2/userNotifications/{userNotificationId}/ \
  -H "Authorization: Bearer {access-token}"

Parameters

Name In Type Required Description
userNotificationId path string true Unique identifier of the notification.

Responses

Status Meaning Description Schema
204 No Content Notification was marked as read. None

To perform this operation, you must be authenticated by means of one of the following methods:

BearerAuth

Schemas

CreateRemoteEventResponse

{
  "message": "string"
}

Properties

Name Type Required Restrictions Description
message string true The descriptive message about the event creation.

CustomerHeader

{
  "name": "string",
  "value": "string"
}

Properties

Name Type Required Restrictions Description
name string true The name of the header.
value string true The value of the header.

EventGroup

{
  "events": [
    {
      "id": "string",
      "label": "string"
    }
  ],
  "id": "string",
  "label": "string"
}

Properties

Name Type Required Restrictions Description
events [EventType] true The events included in this group.
id string true The id of the event group.
label string true The display name of the event group.

EventGroupResponse

{
  "events": [
    "string"
  ],
  "id": "string",
  "label": "string"
}

Properties

Name Type Required Restrictions Description
events [string] true Event types belonging to the group
id string true Group ID
label string true Group name for display

EventResponse

{
  "id": "string",
  "label": "string"
}

Properties

Name Type Required Restrictions Description
id string true Event type as an ID
label string true Event type for display

EventType

{
  "id": "string",
  "label": "string"
}

Properties

Name Type Required Restrictions Description
id string true The id of the event type.
label string true The display name of the event type.

ExternalNaNPredictionsEventData

{
  "count": 0,
  "modelId": null
}

Properties

Name Type Required Restrictions Description
count integer true minimum: 0 (exclusive)
Number of NaN predictions by external model
modelId string¦null true The identifier of the model.

NotificationChannel

{
  "channelType": "Database",
  "contentType": "application/json",
  "createdAt": "2019-08-24T14:15:22Z",
  "customHeaders": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "emailAddress": "string",
  "id": "string",
  "languageCode": "en",
  "name": "string",
  "orgId": "string",
  "payloadUrl": "http://example.com",
  "secretToken": "string",
  "uid": "string",
  "updatedAt": "2019-08-24T14:15:22Z",
  "validateSsl": true
}

Properties

Name Type Required Restrictions Description
channelType string true The type of the new notification channel.
contentType string¦null true The content type of the messages of the new notification channel.
createdAt string(date-time) true The date of the notification channel creation.
customHeaders [CustomerHeader]¦null true Custom headers and their values to be sent in the new notification channel.
emailAddress string¦null true The email address to be used in the new notification channel.
id string true The id of the notification channel.
languageCode string¦null true The preferred language code.
name string true The name of the new notification channel.
orgId string¦null true The id of organization that notification channel belongs to.
payloadUrl string(uri)¦null true The payload URL of the new notification channel.
secretToken string¦null true Secret token to be used for new notification channel.
uid string¦null true The identifier of the user who created the channel.
updatedAt string(date-time)¦null true The date when the channel was updated.
validateSsl boolean¦null true Defines if validate ssl or not in the notification channel.

Enumerated Values

Property Value
channelType [Database, Email, InApp, InsightsComputations, MSTeams, Slack, Webhook]
contentType [application/json, application/x-www-form-urlencoded]
languageCode [en, es_419, fr, ja, ko, ptBR]

NotificationChannelCreate

{
  "channelType": "Database",
  "contentType": "application/json",
  "customHeaders": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "emailAddress": "string",
  "languageCode": "en",
  "name": "string",
  "orgId": "string",
  "payloadUrl": "http://example.com",
  "secretToken": "string",
  "validateSsl": true,
  "verificationCode": "string"
}

Properties

Name Type Required Restrictions Description
channelType string true The type of the new notification channel.
contentType string false The content type of the messages of the new notification channel.
customHeaders [CustomerHeader] false Custom headers and their values to be sent in the new notification channel.
emailAddress string false The email address to be used in the new notification channel.
languageCode string false The preferred language code.
name string true maxLength: 100
The name of the new notification channel.
orgId string false The id of organization that notification channel belongs to.
payloadUrl string(uri) false The payload URL of the new notification channel.
secretToken string false Secret token to be used for new notification channel.
validateSsl boolean false Defines if validate ssl or not in the notification channel.
verificationCode string false Required if the channel type is Email.

Enumerated Values

Property Value
channelType [Database, Email, InApp, InsightsComputations, MSTeams, Slack, Webhook]
contentType [application/json, application/x-www-form-urlencoded]
languageCode [en, es_419, fr, ja, ko, ptBR]

NotificationChannelResponse

{
  "channelType": "Database",
  "contentType": "application/json",
  "createdAt": "2019-08-24T14:15:22Z",
  "customHeaders": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "emailAddress": "string",
  "id": "string",
  "languageCode": "en",
  "lastNotificationAt": "2019-08-24T14:15:22Z",
  "name": "string",
  "orgId": "string",
  "payloadUrl": "http://example.com",
  "policyCount": 0,
  "secretToken": "string",
  "uid": "string",
  "updatedAt": "2019-08-24T14:15:22Z",
  "validateSsl": true
}

Properties

Name Type Required Restrictions Description
channelType string true The type of the new notification channel.
contentType string¦null true The content type of the messages of the new notification channel.
createdAt string(date-time) true The date of the notification channel creation.
customHeaders [CustomerHeader]¦null true Custom headers and their values to be sent in the new notification channel.
emailAddress string¦null true The email address to be used in the new notification channel.
id string true The id of the notification channel.
languageCode string¦null true The preferred language code.
lastNotificationAt string(date-time)¦null true The timestamp of the last notification sent to the channel.
name string true The name of the new notification channel.
orgId string¦null true The id of organization that notification channel belongs to.
payloadUrl string(uri)¦null true The payload URL of the new notification channel.
policyCount integer true Count of policies assigned to the channel.
secretToken string¦null true Secret token to be used for new notification channel.
uid string¦null true The identifier of the user who created the channel.
updatedAt string(date-time)¦null true The date when the channel was updated.
validateSsl boolean¦null true Defines if validate ssl or not in the notification channel.

Enumerated Values

Property Value
channelType [Database, Email, InApp, InsightsComputations, MSTeams, Slack, Webhook]
contentType [application/json, application/x-www-form-urlencoded]
languageCode [en, es_419, fr, ja, ko, ptBR]

NotificationChannelUpdate

{
  "contentType": "application/json",
  "customHeaders": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "emailAddress": "string",
  "languageCode": "en",
  "name": "string",
  "payloadUrl": "http://example.com",
  "secretToken": "string",
  "validateSsl": true,
  "verificationCode": "string"
}

Properties

Name Type Required Restrictions Description
contentType string false The content type of the messages of the new notification channel.
customHeaders [CustomerHeader] false Custom headers and their values to be sent in the new notification channel.
emailAddress string false The email address to be used in the new notification channel.
languageCode string false The preferred language code.
name string false maxLength: 100
The name of the new notification channel.
payloadUrl string(uri) false The payload URL of the new notification channel.
secretToken string false Secret token to be used for new notification channel.
validateSsl boolean false Defines if validate ssl or not in the notification channel.
verificationCode string false Required if the channel type is Email.

Enumerated Values

Property Value
contentType [application/json, application/x-www-form-urlencoded]
languageCode [en, es_419, fr, ja, ko, ptBR]

NotificationChannelsListResponse

{
  "count": 0,
  "data": [
    {
      "channelType": "Database",
      "contentType": "application/json",
      "createdAt": "2019-08-24T14:15:22Z",
      "customHeaders": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "emailAddress": "string",
      "id": "string",
      "languageCode": "en",
      "lastNotificationAt": "2019-08-24T14:15:22Z",
      "name": "string",
      "orgId": "string",
      "payloadUrl": "http://example.com",
      "policyCount": 0,
      "secretToken": "string",
      "uid": "string",
      "updatedAt": "2019-08-24T14:15:22Z",
      "validateSsl": true
    }
  ],
  "next": "string",
  "previous": "string",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer true The number of channels returned.
data [NotificationChannelResponse] true The notification channels.
next string¦null true URL pointing to the next page.
previous string¦null true URL pointing to the previous page.
totalCount integer true The total number of channels that satisfy the query.

NotificationEmailChannelVerification

{
  "channelType": "string",
  "emailAddress": "string",
  "name": "string",
  "orgId": "string"
}

Properties

Name Type Required Restrictions Description
channelType string true The type of the new notification channel
emailAddress string true The email address of the recipient
name string true maxLength: 100
The name of the new notification channel
orgId string false The id of organization that notification channel belongs to

NotificationEmailChannelVerificationResponse

{
  "notificationId": "string"
}

Properties

Name Type Required Restrictions Description
notificationId string true The response body is the json object with notification_id in it

NotificationEmailChannelVerificationStatus

{
  "emailAddress": "string",
  "verificationCode": "string"
}

Properties

Name Type Required Restrictions Description
emailAddress string true The email address of the recipient
verificationCode string true The user entered verification code

NotificationEmailChannelVerificationStatusResponse

{
  "status": true
}

Properties

Name Type Required Restrictions Description
status boolean true The status shows if admin entered the correct 6 digit verification code

NotificationEventListResponse

{
  "eventGroups": [
    {
      "events": [
        "string"
      ],
      "id": "string",
      "label": "string"
    }
  ],
  "events": [
    {
      "id": "string",
      "label": "string"
    }
  ]
}

Properties

Name Type Required Restrictions Description
eventGroups [EventGroupResponse] true Selectable event groups
events [EventResponse] true Selectable individual events

NotificationLog

{
  "channelId": "string",
  "channelScope": "organization",
  "emailSubject": "string",
  "id": "string",
  "parentNotificationId": "string",
  "policyId": "string",
  "request": "string",
  "response": "string",
  "retryCount": 0,
  "status": "string",
  "timestamp": "2019-08-24T14:15:22Z"
}

Properties

Name Type Required Restrictions Description
channelId string true The id of the channel that was used to send the notification.
channelScope string¦null true Scope of the channel.
emailSubject string¦null true The email subject of the notification.
id string true The id of the notification log.
parentNotificationId string¦null true The id of the parent notification.
policyId string true The id of the policy that was used to send the notification.
request string¦null true The request that was sent in the notification.
response string¦null true The response that was received after sending the notification.
retryCount integer¦null true The number of attempts to send the notification.
status string true The status of the notification.
timestamp string(date-time) true The date when the notification was sent.

Enumerated Values

Property Value
channelScope [organization, Organization, ORGANIZATION, entity, Entity, ENTITY, template, Template, TEMPLATE]

NotificationLogListDataResponse

{
  "channelId": "string",
  "channelScope": "organization",
  "emailSubject": "string",
  "id": "string",
  "parentNotificationId": "string",
  "policyId": "string",
  "request": {
    "body": "string",
    "headers": "string",
    "url": "http://example.com"
  },
  "response": {
    "body": "string",
    "duration": 0,
    "headers": "string",
    "statusCode": "string"
  },
  "retryCount": 0,
  "status": "string",
  "timestamp": "2019-08-24T14:15:22Z"
}

Properties

Name Type Required Restrictions Description
channelId string true The id of the channel that was used to send the notification
channelScope string¦null true Scope of the channel.
emailSubject string true The email subject
id string true The id of the notification log
parentNotificationId string¦null true The ID of the parent notification
policyId string true the id of the policy that was used to send the notification
request RequestNotification true The request that was sent in the notification
response ResponseNotification true The response that was received after sending the notification
retryCount integer true The count of the retries while sending the notification
status string¦null true The status of the notification
timestamp string(date-time) true The date and time when the notification was sent

Enumerated Values

Property Value
channelScope [organization, Organization, ORGANIZATION, entity, Entity, ENTITY, template, Template, TEMPLATE]

NotificationLogListResponse

{
  "count": 0,
  "data": [
    {
      "channelId": "string",
      "channelScope": "organization",
      "emailSubject": "string",
      "id": "string",
      "parentNotificationId": "string",
      "policyId": "string",
      "request": {
        "body": "string",
        "headers": "string",
        "url": "http://example.com"
      },
      "response": {
        "body": "string",
        "duration": 0,
        "headers": "string",
        "statusCode": "string"
      },
      "retryCount": 0,
      "status": "string",
      "timestamp": "2019-08-24T14:15:22Z"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer true Number of items returned on this page
data [NotificationLogListDataResponse] true An array notification logs
next string(uri)¦null true URL pointing to the next page (if null, there is no next page)
previous string(uri)¦null true URL pointing to the previous page (if null, there is no previous page)
totalCount integer false The total number of notifications

NotificationPoliciesListResponse

{
  "count": 0,
  "data": [
    {
      "active": true,
      "channel": {
        "channelType": "Database",
        "contentType": "application/json",
        "createdAt": "2019-08-24T14:15:22Z",
        "customHeaders": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "emailAddress": "string",
        "id": "string",
        "languageCode": "en",
        "name": "string",
        "orgId": "string",
        "payloadUrl": "http://example.com",
        "secretToken": "string",
        "uid": "string",
        "updatedAt": "2019-08-24T14:15:22Z",
        "validateSsl": true
      },
      "channelId": "string",
      "created": "2019-08-24T14:15:22Z",
      "eventGroup": {
        "events": [
          {
            "id": "string",
            "label": "string"
          }
        ],
        "id": "string",
        "label": "string"
      },
      "eventType": {
        "id": "string",
        "label": "string"
      },
      "id": "string",
      "lastTriggered": "2019-08-24T14:15:22Z",
      "name": "string",
      "orgId": "string",
      "uid": "string",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "next": "string",
  "previous": "string",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer true The number of policies returned.
data [NotificationPolicyResponse] true The notification policies.
next string¦null true URL pointing to the next page.
previous string¦null true URL pointing to the previous page.
totalCount integer true The total number of policies that satisfy the query.

NotificationPolicyCreate

{
  "active": true,
  "channelId": "string",
  "eventGroup": "secure_config.all",
  "eventType": "secure_config.created",
  "name": "string",
  "orgId": "string"
}

Properties

Name Type Required Restrictions Description
active boolean false Defines if the notification policy is active or not.
channelId string true The id of the notification channel to be used to send the notification.
eventGroup string false The group of the event that trigger the notification.
eventType string false The type of the event that triggers the notification.
name string true maxLength: 100
The name of the new notification policy.
orgId string false The id of the organization that owns the notification policy.

Enumerated Values

Property Value
eventGroup [secure_config.all, comment.all, dataset.all, deployment_prediction_explanations_computation.all, model_deployments.critical_health, model_deployments.critical_frequent_health_change, model_deployments.frequent_health_change, model_deployments.health, inference_endpoints.health, model_deployments.management_agent, model_deployments.management_agent_health, prediction_request.all, challenger_management.all, challenger_replay.all, model_deployments.all, project.all, perma_delete_project.all, users_delete.all, applications.all, batch_predictions.all, change_requests.all, insights_computation.all, notebook_schedule.all, monitoring.all]
eventType [secure_config.created, secure_config.deleted, secure_config.shared, comment.created, comment.updated, credits_system.empty_balance, credits_system.credits_applied, credits_system.credits_expired, credits_system.credits_usage, dataset.created, dataset.registered, dataset.deleted, datasets.deleted, datasetrelationship.created, dataset.shared, datasets.shared, decision_flow.shared, misc.asset_access_request, misc.webhook_connection_test, misc.webhook_resend, misc.email_verification, monitoring.spooler_channel_base, monitoring.spooler_channel_red, monitoring.spooler_channel_green, monitoring.external_model_nan_predictions, management.deploymentInfo, model_deployments.None, model_deployments.deployment_sharing, model_deployments.model_replacement, prediction_request.None, prediction_request.failed, model_deployments.model_replacement_lifecycle, model_deployments.model_replacement_started, model_deployments.model_replacement_succeeded, model_deployments.model_replacement_failed, model_deployments.model_replacement_validation_warning, model_deployments.deployment_creation, model_deployments.deployment_deletion, model_deployments.service_health_yellow_from_green, model_deployments.service_health_yellow_from_red, model_deployments.service_health_red, model_deployments.data_drift_yellow_from_green, model_deployments.data_drift_yellow_from_red, model_deployments.data_drift_red, model_deployments.accuracy_yellow_from_green, model_deployments.accuracy_yellow_from_red, model_deployments.accuracy_red, model_deployments.health.fairness_health.green_to_yellow, model_deployments.health.fairness_health.red_to_yellow, model_deployments.health.fairness_health.red, model_deployments.health.custom_metrics_health.green_to_yellow, model_deployments.health.custom_metrics_health.red_to_yellow, model_deployments.health.custom_metrics_health.red, model_deployments.health.base.green, model_deployments.service_health_green, model_deployments.data_drift_green, model_deployments.accuracy_green, model_deployments.health.fairness_health.green, model_deployments.health.custom_metrics_health.green, model_deployments.retraining_policy_run_started, model_deployments.retraining_policy_run_succeeded, model_deployments.retraining_policy_run_failed, model_deployments.challenger_scoring_finished, model_deployments.challenger_scoring_success, model_deployments.challenger_scoring_data_warning, model_deployments.challenger_scoring_failure, model_deployments.challenger_scoring_started, model_deployments.challenger_model_validation_warning, model_deployments.challenger_model_created, model_deployments.challenger_model_deleted, model_deployments.actuals_upload_failed, model_deployments.actuals_upload_warning, model_deployments.training_data_baseline_calculation_started, model_deployments.training_data_baseline_calculation_completed, model_deployments.training_data_baseline_failed, model_deployments.custom_model_deployment_creation_started, model_deployments.custom_model_deployment_creation_completed, model_deployments.custom_model_deployment_creation_failed, model_deployments.deployment_prediction_explanations_preview_job_submitted, model_deployments.deployment_prediction_explanations_preview_job_completed, model_deployments.deployment_prediction_explanations_preview_job_failed, model_deployments.custom_model_deployment_activated, model_deployments.custom_model_deployment_deactivated, model_deployments.prediction_processing_rate_limit_reached, model_deployments.prediction_data_processing_rate_limit_reached, model_deployments.prediction_data_processing_rate_limit_warning, model_deployments.actuals_processing_rate_limit_reached, model_deployments.actuals_processing_rate_limit_warning, model_deployments.deployment_monitoring_data_cleared, model_deployments.deployment_launch_started, model_deployments.deployment_launch_succeeded, model_deployments.deployment_launch_failed, model_deployments.deployment_shutdown_started, model_deployments.deployment_shutdown_succeeded, model_deployments.deployment_shutdown_failed, model_deployments.endpoint_update_started, model_deployments.endpoint_update_succeeded, model_deployments.endpoint_update_failed, model_deployments.management_agent_service_health_green, model_deployments.management_agent_service_health_yellow, model_deployments.management_agent_service_health_red, model_deployments.management_agent_service_health_unknown, model_deployments.predictions_missing_association_id, model_deployments.prediction_result_rows_cleand_up, model_deployments.batch_deleted, model_deployments.batch_creation_limit_reached, model_deployments.batch_creation_limit_exceeded, model_deployments.batch_not_found, model_deployments.predictions_encountered_for_locked_batch, model_deployments.predictions_encountered_for_deleted_batch, model_deployments.scheduled_report_generated, model_deployments.predictions_timeliness_health_red, model_deployments.actuals_timeliness_health_red, model_deployments.service_health_still_red, model_deployments.data_drift_still_red, model_deployments.accuracy_still_red, model_deployments.health.fairness_health.still_red, model_deployments.health.custom_metrics_health.still_red, model_deployments.predictions_timeliness_health_still_red, model_deployments.actuals_timeliness_health_still_red, model_deployments.service_health_still_yellow, model_deployments.data_drift_still_yellow, model_deployments.accuracy_still_yellow, model_deployments.health.fairness_health.still_yellow, model_deployments.health.custom_metrics_health.still_yellow, entity_notification_policy_template.shared, notification_channel_template.shared, project.created, project.deleted, project.shared, autopilot.complete, autopilot.started, autostart.failure, perma_delete_project.success, perma_delete_project.failure, users_delete.preview_started, users_delete.preview_completed, users_delete.preview_failed, users_delete.started, users_delete.completed, users_delete.failed, application.created, application.shared, batch_predictions.success, batch_predictions.failed, batch_predictions.scheduler.auto_disabled, change_request.cancelled, change_request.created, change_request.deployment_approval_requested, change_request.resolved, change_request.proposed_changes_updated, change_request.pending, change_request.commenting_review_added, change_request.approving_review_added, change_request.changes_requesting_review_added, prediction_explanations_computation.None, prediction_explanations_computation.prediction_explanations_preview_job_submitted, prediction_explanations_computation.prediction_explanations_preview_job_completed, prediction_explanations_computation.prediction_explanations_preview_job_failed, monitoring.rate_limit_enforced, notebook_schedule.created, notebook_schedule.failure, notebook_schedule.completed]

NotificationPolicyMuteCreate

{
  "entityId": "string",
  "policyId": "string"
}

Properties

Name Type Required Restrictions Description
entityId string true The id of the entity to mute the notification for
policyId string true The id of the policy to mute notification for

NotificationPolicyMuteListResponse

{
  "count": 0,
  "data": [
    {
      "entityId": "string",
      "id": "string",
      "policyId": "string",
      "uid": "string"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer true The number of items returned on this page
data [NotificationPolicyMuteResponse] true A list of Notification Policy Mutes
next string(uri)¦null true URL pointing to the next page (if null, there is no next page)
previous string(uri)¦null true URL pointing to the previous page (if null, there is no previous page)
totalCount integer true The total number of items returned by the query

NotificationPolicyMuteResponse

{
  "entityId": "string",
  "id": "string",
  "policyId": "string",
  "uid": "string"
}

Properties

Name Type Required Restrictions Description
entityId string true The id of the entity to mute the notification for
id string true The id of the notification policy mute
policyId string true The id of the policy to mute notification for
uid string true The uid of the notification policy mute

NotificationPolicyResponse

{
  "active": true,
  "channel": {
    "channelType": "Database",
    "contentType": "application/json",
    "createdAt": "2019-08-24T14:15:22Z",
    "customHeaders": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "emailAddress": "string",
    "id": "string",
    "languageCode": "en",
    "name": "string",
    "orgId": "string",
    "payloadUrl": "http://example.com",
    "secretToken": "string",
    "uid": "string",
    "updatedAt": "2019-08-24T14:15:22Z",
    "validateSsl": true
  },
  "channelId": "string",
  "created": "2019-08-24T14:15:22Z",
  "eventGroup": {
    "events": [
      {
        "id": "string",
        "label": "string"
      }
    ],
    "id": "string",
    "label": "string"
  },
  "eventType": {
    "id": "string",
    "label": "string"
  },
  "id": "string",
  "lastTriggered": "2019-08-24T14:15:22Z",
  "name": "string",
  "orgId": "string",
  "uid": "string",
  "updatedAt": "2019-08-24T14:15:22Z"
}

Properties

Name Type Required Restrictions Description
active boolean true Defines if the notification policy is active or not.
channel NotificationChannel true The information notification channel to be used to send the notification.
channelId string true The id of the notification channel to be used to send the notification.
created string(date-time)¦null true The date when the policy was created.
eventGroup EventGroup true The group of the event that trigger the notification.
eventType EventType true The type of the event that triggers the notification.
id string true The id of the policy.
lastTriggered string(date-time)¦null true The date when the last notification with the policy was triggered.
name string true The name of the notification policy.
orgId string¦null true The id of the organization that owns the notification policy.
uid string true The identifier of the user who created the policy.
updatedAt string(date-time)¦null true The date when the policy was updated.

NotificationPolicyUpdate

{
  "active": true,
  "channelId": "string",
  "eventGroup": "secure_config.all",
  "eventType": "secure_config.created",
  "name": "string"
}

Properties

Name Type Required Restrictions Description
active boolean false Defines if the notification policy is active or not.
channelId string false The id of the notification channel to be used to send the notification.
eventGroup string false The group of the event that trigger the notification.
eventType string false The type of the event that triggers the notification.
name string false maxLength: 100
The name of the notification policy.

Enumerated Values

Property Value
eventGroup [secure_config.all, comment.all, dataset.all, deployment_prediction_explanations_computation.all, model_deployments.critical_health, model_deployments.critical_frequent_health_change, model_deployments.frequent_health_change, model_deployments.health, inference_endpoints.health, model_deployments.management_agent, model_deployments.management_agent_health, prediction_request.all, challenger_management.all, challenger_replay.all, model_deployments.all, project.all, perma_delete_project.all, users_delete.all, applications.all, batch_predictions.all, change_requests.all, insights_computation.all, notebook_schedule.all, monitoring.all]
eventType [secure_config.created, secure_config.deleted, secure_config.shared, comment.created, comment.updated, credits_system.empty_balance, credits_system.credits_applied, credits_system.credits_expired, credits_system.credits_usage, dataset.created, dataset.registered, dataset.deleted, datasets.deleted, datasetrelationship.created, dataset.shared, datasets.shared, decision_flow.shared, misc.asset_access_request, misc.webhook_connection_test, misc.webhook_resend, misc.email_verification, monitoring.spooler_channel_base, monitoring.spooler_channel_red, monitoring.spooler_channel_green, monitoring.external_model_nan_predictions, management.deploymentInfo, model_deployments.None, model_deployments.deployment_sharing, model_deployments.model_replacement, prediction_request.None, prediction_request.failed, model_deployments.model_replacement_lifecycle, model_deployments.model_replacement_started, model_deployments.model_replacement_succeeded, model_deployments.model_replacement_failed, model_deployments.model_replacement_validation_warning, model_deployments.deployment_creation, model_deployments.deployment_deletion, model_deployments.service_health_yellow_from_green, model_deployments.service_health_yellow_from_red, model_deployments.service_health_red, model_deployments.data_drift_yellow_from_green, model_deployments.data_drift_yellow_from_red, model_deployments.data_drift_red, model_deployments.accuracy_yellow_from_green, model_deployments.accuracy_yellow_from_red, model_deployments.accuracy_red, model_deployments.health.fairness_health.green_to_yellow, model_deployments.health.fairness_health.red_to_yellow, model_deployments.health.fairness_health.red, model_deployments.health.custom_metrics_health.green_to_yellow, model_deployments.health.custom_metrics_health.red_to_yellow, model_deployments.health.custom_metrics_health.red, model_deployments.health.base.green, model_deployments.service_health_green, model_deployments.data_drift_green, model_deployments.accuracy_green, model_deployments.health.fairness_health.green, model_deployments.health.custom_metrics_health.green, model_deployments.retraining_policy_run_started, model_deployments.retraining_policy_run_succeeded, model_deployments.retraining_policy_run_failed, model_deployments.challenger_scoring_finished, model_deployments.challenger_scoring_success, model_deployments.challenger_scoring_data_warning, model_deployments.challenger_scoring_failure, model_deployments.challenger_scoring_started, model_deployments.challenger_model_validation_warning, model_deployments.challenger_model_created, model_deployments.challenger_model_deleted, model_deployments.actuals_upload_failed, model_deployments.actuals_upload_warning, model_deployments.training_data_baseline_calculation_started, model_deployments.training_data_baseline_calculation_completed, model_deployments.training_data_baseline_failed, model_deployments.custom_model_deployment_creation_started, model_deployments.custom_model_deployment_creation_completed, model_deployments.custom_model_deployment_creation_failed, model_deployments.deployment_prediction_explanations_preview_job_submitted, model_deployments.deployment_prediction_explanations_preview_job_completed, model_deployments.deployment_prediction_explanations_preview_job_failed, model_deployments.custom_model_deployment_activated, model_deployments.custom_model_deployment_deactivated, model_deployments.prediction_processing_rate_limit_reached, model_deployments.prediction_data_processing_rate_limit_reached, model_deployments.prediction_data_processing_rate_limit_warning, model_deployments.actuals_processing_rate_limit_reached, model_deployments.actuals_processing_rate_limit_warning, model_deployments.deployment_monitoring_data_cleared, model_deployments.deployment_launch_started, model_deployments.deployment_launch_succeeded, model_deployments.deployment_launch_failed, model_deployments.deployment_shutdown_started, model_deployments.deployment_shutdown_succeeded, model_deployments.deployment_shutdown_failed, model_deployments.endpoint_update_started, model_deployments.endpoint_update_succeeded, model_deployments.endpoint_update_failed, model_deployments.management_agent_service_health_green, model_deployments.management_agent_service_health_yellow, model_deployments.management_agent_service_health_red, model_deployments.management_agent_service_health_unknown, model_deployments.predictions_missing_association_id, model_deployments.prediction_result_rows_cleand_up, model_deployments.batch_deleted, model_deployments.batch_creation_limit_reached, model_deployments.batch_creation_limit_exceeded, model_deployments.batch_not_found, model_deployments.predictions_encountered_for_locked_batch, model_deployments.predictions_encountered_for_deleted_batch, model_deployments.scheduled_report_generated, model_deployments.predictions_timeliness_health_red, model_deployments.actuals_timeliness_health_red, model_deployments.service_health_still_red, model_deployments.data_drift_still_red, model_deployments.accuracy_still_red, model_deployments.health.fairness_health.still_red, model_deployments.health.custom_metrics_health.still_red, model_deployments.predictions_timeliness_health_still_red, model_deployments.actuals_timeliness_health_still_red, model_deployments.service_health_still_yellow, model_deployments.data_drift_still_yellow, model_deployments.accuracy_still_yellow, model_deployments.health.fairness_health.still_yellow, model_deployments.health.custom_metrics_health.still_yellow, entity_notification_policy_template.shared, notification_channel_template.shared, project.created, project.deleted, project.shared, autopilot.complete, autopilot.started, autostart.failure, perma_delete_project.success, perma_delete_project.failure, users_delete.preview_started, users_delete.preview_completed, users_delete.preview_failed, users_delete.started, users_delete.completed, users_delete.failed, application.created, application.shared, batch_predictions.success, batch_predictions.failed, batch_predictions.scheduler.auto_disabled, change_request.cancelled, change_request.created, change_request.deployment_approval_requested, change_request.resolved, change_request.proposed_changes_updated, change_request.pending, change_request.commenting_review_added, change_request.approving_review_added, change_request.changes_requesting_review_added, prediction_explanations_computation.None, prediction_explanations_computation.prediction_explanations_preview_job_submitted, prediction_explanations_computation.prediction_explanations_preview_job_completed, prediction_explanations_computation.prediction_explanations_preview_job_failed, monitoring.rate_limit_enforced, notebook_schedule.created, notebook_schedule.failure, notebook_schedule.completed]

NotificationResend

{
  "notificationId": "string"
}

Properties

Name Type Required Restrictions Description
notificationId string true The id of notification to resend.

NotificationWebhookChannelStatusResponse

{
  "notificationLog": {
    "channelId": "string",
    "channelScope": "organization",
    "emailSubject": "string",
    "id": "string",
    "parentNotificationId": "string",
    "policyId": "string",
    "request": "string",
    "response": "string",
    "retryCount": 0,
    "status": "string",
    "timestamp": "2019-08-24T14:15:22Z"
  },
  "status": "string"
}

Properties

Name Type Required Restrictions Description
notificationLog NotificationLog true The notification log record.
status string true The status of the test notification.

NotificationWebhookChannelTestCreate

{
  "channelType": "Database",
  "contentType": "application/json",
  "customHeaders": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "emailAddress": "string",
  "name": "string",
  "orgId": "string",
  "payloadUrl": "http://example.com",
  "secretToken": "string",
  "validateSsl": true
}

Properties

Name Type Required Restrictions Description
channelType string true The type of the new notification channel.
contentType string false The content type of the messages of the new notification channel.
customHeaders [CustomerHeader] false Custom headers and their values to be sent in the new notification channel.
emailAddress string false The email address to be used in the new notification channel.
name string true maxLength: 100
The name of the new notification channel.
orgId string false The identifier of the organization that notification channel belongs to.
payloadUrl string(uri) false The payload URL of the new notification channel.
secretToken string false Secret token to be used for new notification channel.
validateSsl boolean false Whether SSL will be validated in the notification channel.

Enumerated Values

Property Value
channelType [Database, Email, InApp, InsightsComputations, MSTeams, Slack, Webhook]
contentType [application/json, application/x-www-form-urlencoded]

NotificationWebhookChannelTestId

{
  "notificationId": "string"
}

Properties

Name Type Required Restrictions Description
notificationId string true The identifier of the notification.

PredictionRemoteEventData

{
  "error_code": "string",
  "model_id": "string",
  "response_body": "string",
  "status_code": 0,
  "user_id": "string"
}

Properties

Name Type Required Restrictions Description
error_code string¦null false The error code if any.
model_id string¦null false The identifier of the model.
response_body string true The response body message of the prediction event.
status_code integer true The response status code of the prediction event.
user_id string¦null false The identifier of the user that accesses the deployment.

RemoteEventCreate

{
  "data": {
    "newModelId": "string",
    "oldModelId": "string",
    "reason": "string"
  },
  "deploymentId": "string",
  "eventType": "deploymentInfo",
  "externalNanPredictionsData": {
    "count": 0,
    "modelId": null
  },
  "message": "string",
  "orgId": "string",
  "predictionEnvironmentId": "string",
  "predictionRequestData": {
    "error_code": "string",
    "model_id": "string",
    "response_body": "string",
    "status_code": 0,
    "user_id": "string"
  },
  "spoolerChannelData": {
    "name": "string",
    "type": "asyncMemory"
  },
  "timestamp": "2019-08-24T14:15:22Z",
  "title": "string"
}

Properties

Name Type Required Restrictions Description
data RemoteEventData false Event payload.
deploymentId string false The identifier of the deployment associated with the event.
eventType string true The type of the event. Labels in all_lower_case are deprecated.
externalNanPredictionsData ExternalNaNPredictionsEventData false External NaN Predictions event payload
message string false maxLength: 16384
Descriptive message for health events.
orgId string¦null false The identifier of the organization associated with the event.
predictionEnvironmentId string false The identifier of the prediction environment associated with the event.
predictionRequestData PredictionRemoteEventData false Prediction event payload.
spoolerChannelData SpoolerChannelEventData false Spooler channel event payload.
timestamp string(date-time) true The time when the event occurred.
title string false maxLength: 512
The title of the event.

Enumerated Values

Property Value
eventType [deploymentInfo, externalNaNPredictions, management.deploymentInfo, model_deployments.accuracy_green, model_deployments.accuracy_red, model_deployments.accuracy_yellow_from_green, model_deployments.data_drift_green, model_deployments.data_drift_red, model_deployments.data_drift_yellow_from_green, model_deployments.model_replacement, model_deployments.service_health_green, model_deployments.service_health_red, model_deployments.service_health_yellow_from_green, monitoring.external_model_nan_predictions, monitoring.spooler_channel_green, monitoring.spooler_channel_red, predictionRequestFailed, prediction_request.failed, serviceHealthChangeGreen, serviceHealthChangeRed, serviceHealthChangeYellowFromGreen, spoolerChannelGreen, spoolerChannelRed]

RemoteEventData

{
  "newModelId": "string",
  "oldModelId": "string",
  "reason": "string"
}

Properties

Name Type Required Restrictions Description
newModelId string false The identifier of the model after replacement.
oldModelId string false The identifier of the model before replacement.
reason string false The explanation on why the model has been replaced.

RequestNotification

{
  "body": "string",
  "headers": "string",
  "url": "http://example.com"
}

Properties

Name Type Required Restrictions Description
body string true The body of the request
headers string true The headers of the request
url string(uri)¦null true The URL of the request

ResponseNotification

{
  "body": "string",
  "duration": 0,
  "headers": "string",
  "statusCode": "string"
}

Properties

Name Type Required Restrictions Description
body string true The body of the response
duration integer true The duration
headers string true The headers of the response
statusCode string true The status code of the response

SpoolerChannelEventData

{
  "name": "string",
  "type": "asyncMemory"
}

Properties

Name Type Required Restrictions Description
name string true maxLength: 512
Name or label of the spooler channel.
type string true Type of the spooler channel.

Enumerated Values

Property Value
type [asyncMemory, filesystem, kafka, memory, pubSub, rabbitMQ, sqs]

UserNotificationListResponse

{
  "count": 0,
  "data": [
    {
      "callerUser": {
        "fullName": "string",
        "gravatarHash": "string",
        "inactive": true,
        "uid": "string",
        "username": "string"
      },
      "created": "2019-08-24T14:15:22Z",
      "description": "string",
      "eventType": "autopilot.complete",
      "isRead": true,
      "link": "string",
      "pushNotificationSent": true,
      "relatedComment": {
        "commentId": "string",
        "commentLink": "string",
        "entityId": "string",
        "entityType": "useCase",
        "inactive": true
      },
      "relatedDeployment": {
        "deploymentId": "string",
        "deploymentName": "string",
        "deploymentUrl": "string",
        "inactive": true,
        "modelId": "string",
        "projectId": "string",
        "userId": "string"
      },
      "relatedProject": {
        "inactive": true,
        "pid": "string",
        "projectLink": "string",
        "projectName": "string"
      },
      "relatedSecureConfig": {
        "secureConfigLink": "string",
        "secureConfigName": "string",
        "secureConfigSchemaName": "string",
        "secureConfigSchemaUuid": "string",
        "secureConfigUuid": "string"
      },
      "relatedUsersDelete": {
        "reportId": "string",
        "statusId": "string",
        "usersToDeleteCount": "string"
      },
      "sharedUsers": [
        {
          "fullName": "string",
          "gravatarHash": "string",
          "inactive": true,
          "uid": "string",
          "username": "string"
        }
      ],
      "statusId": "string",
      "title": "string",
      "tooltip": "string",
      "updated": "2019-08-24T14:15:22Z",
      "userNotificationId": "string"
    }
  ],
  "next": "http://example.com",
  "previous": "http://example.com",
  "totalCount": 0
}

Properties

Name Type Required Restrictions Description
count integer false Number of items returned on this page.
data [UserNotificationResponse] true An array of user's notifications.
next string(uri)¦null true URL pointing to the next page (if null, there is no next page).
previous string(uri)¦null true URL pointing to the previous page (if null, there is no previous page).
totalCount integer true The total number of items across all pages.

UserNotificationRelatedCommentResponse

{
  "commentId": "string",
  "commentLink": "string",
  "entityId": "string",
  "entityType": "useCase",
  "inactive": true
}

Properties

Name Type Required Restrictions Description
commentId string true The ID of the comment
commentLink string false The link to the comment.
entityId string true The ID of the commented entity
entityType string false The type of the commented entity.
inactive boolean false True if the comment was deleted.

Enumerated Values

Property Value
entityType [useCase, model, catalog]

UserNotificationRelatedDeploymentResponse

{
  "deploymentId": "string",
  "deploymentName": "string",
  "deploymentUrl": "string",
  "inactive": true,
  "modelId": "string",
  "projectId": "string",
  "userId": "string"
}

Properties

Name Type Required Restrictions Description
deploymentId string true The ID of the deployment
deploymentName string¦null false Deployment's label
deploymentUrl string false The link to the deployment
inactive boolean false True if the deployment was deleted.
modelId string¦null false The ID of the related model
projectId string¦null false The ID of the related project
userId string¦null false The ID of the related user

UserNotificationRelatedProjectResponse

{
  "inactive": true,
  "pid": "string",
  "projectLink": "string",
  "projectName": "string"
}

Properties

Name Type Required Restrictions Description
inactive boolean false True if the project was deleted.
pid string true The ID of the project
projectLink string false The link to the project.
projectName string¦null false Project name.

UserNotificationRelatedSecureConfigResponse

{
  "secureConfigLink": "string",
  "secureConfigName": "string",
  "secureConfigSchemaName": "string",
  "secureConfigSchemaUuid": "string",
  "secureConfigUuid": "string"
}

Properties

Name Type Required Restrictions Description
secureConfigLink string true Link to the secure config.
secureConfigName string true Name of the secure config.
secureConfigSchemaName string true Type uuid of the secure config.
secureConfigSchemaUuid string true Type name of the secure config.
secureConfigUuid string true ID of the secure config.

UserNotificationRelatedUserResponse

{
  "fullName": "string",
  "gravatarHash": "string",
  "inactive": true,
  "uid": "string",
  "username": "string"
}

Properties

Name Type Required Restrictions Description
fullName string¦null false User's full name.
gravatarHash string false User's gravatar hash.
inactive boolean false True if the user was deleted.
uid string true The ID of the user
username string false Username of the user.

UserNotificationRelatedUsersDeleteResponse

{
  "reportId": "string",
  "statusId": "string",
  "usersToDeleteCount": "string"
}

Properties

Name Type Required Restrictions Description
reportId string true The ID of the users permanent delete report
statusId string true The ID of the users delete status.
usersToDeleteCount string true Number of users that will be deleted.

UserNotificationResponse

{
  "callerUser": {
    "fullName": "string",
    "gravatarHash": "string",
    "inactive": true,
    "uid": "string",
    "username": "string"
  },
  "created": "2019-08-24T14:15:22Z",
  "description": "string",
  "eventType": "autopilot.complete",
  "isRead": true,
  "link": "string",
  "pushNotificationSent": true,
  "relatedComment": {
    "commentId": "string",
    "commentLink": "string",
    "entityId": "string",
    "entityType": "useCase",
    "inactive": true
  },
  "relatedDeployment": {
    "deploymentId": "string",
    "deploymentName": "string",
    "deploymentUrl": "string",
    "inactive": true,
    "modelId": "string",
    "projectId": "string",
    "userId": "string"
  },
  "relatedProject": {
    "inactive": true,
    "pid": "string",
    "projectLink": "string",
    "projectName": "string"
  },
  "relatedSecureConfig": {
    "secureConfigLink": "string",
    "secureConfigName": "string",
    "secureConfigSchemaName": "string",
    "secureConfigSchemaUuid": "string",
    "secureConfigUuid": "string"
  },
  "relatedUsersDelete": {
    "reportId": "string",
    "statusId": "string",
    "usersToDeleteCount": "string"
  },
  "sharedUsers": [
    {
      "fullName": "string",
      "gravatarHash": "string",
      "inactive": true,
      "uid": "string",
      "username": "string"
    }
  ],
  "statusId": "string",
  "title": "string",
  "tooltip": "string",
  "updated": "2019-08-24T14:15:22Z",
  "userNotificationId": "string"
}

Properties

Name Type Required Restrictions Description
callerUser UserNotificationRelatedUserResponse true Details about the user who triggered the notification.
created string(date-time) true The ISO 8601 formatted date and time when the notification was created.
description string¦null true Notification's description
eventType string true The type of the notification.
isRead boolean true True if the notification is already read.
link string true Call-to-action link for the notification
pushNotificationSent boolean true True if the notification was also sent via push notifications.
relatedComment UserNotificationRelatedCommentResponse false Details about the comment related to the notification.
relatedDeployment UserNotificationRelatedDeploymentResponse false Details about the deployment related to the notification.
relatedProject UserNotificationRelatedProjectResponse false Details about the project related to the notification.
relatedSecureConfig UserNotificationRelatedSecureConfigResponse false Details about the secure config related to the notification.
relatedUsersDelete UserNotificationRelatedUsersDeleteResponse false Details about the users permanent delete.
sharedUsers [UserNotificationRelatedUserResponse] false List of the user details a resource was shared with.
statusId string false Asynchronous job status ID
title string¦null true Notification's title
tooltip string¦null true Notification's tooltip
updated string(date-time) true The ISO 8601 formatted date and time when the notification was updated.
userNotificationId string true The ID of the notification

Enumerated Values

Property Value
eventType [autopilot.complete, project.shared, comment.created, comment.updated, model_deployments.service_health_red, model_deployments.data_drift_red, model_deployments.accuracy_red, model_deployments.health.fairness_health.red, model_deployments.health.custom_metrics_health.red, model_deployments.predictions_timeliness_health_red, model_deployments.actuals_timeliness_health_red, model_deployments.challenger_scoring_finished, credits_system.credits_applied, credits_system.credits_expired, credits_system.empty_balance, credits_system.credits_usage, misc.asset_access_request, users_delete.preview_started, users_delete.preview_completed, users_delete.preview_failed, perma_delete_project.failure, perma_delete_project.success, decision_flow.shared, secure_config.shared, entity_notification_policy_template.shared, notification_channel_template.shared]

更新しました April 24, 2024