RestApiCategories.modelsAndDecisions.desc

models_and_decisions

2026.07

The Model Management API provides basic resources for monitoring performance, comparing models, and running workflow processes.

Model Management

2026.04

2025.09

2026.05

2026.06

2026.03

2024.09

2025.03

Viya_35

Updates an existing alert rule for a project.

Alert Rule

The entity tag that was returned in the `ETag` response header from a previous GET request. Required to prevent concurrent modification conflicts.

If-Match

The ID of a project in the common model repository.

projectId

alertRuleId

A tag that identifies the revision of the updated alert rule.

ETag

Last-Modified

The alert rule ID is either missing or an invalid UUID.

Error

application/vnd.sas.error

The request was invalid or the alert rule ID was not found.

The specified project ID could not be found.

The project ID or alert rule ID is not valid.

The `If-Match` request header did not match the resource's entity tag (ETag).

The request headers did not include a required `If-Match` or `If-Unmodified-Since` precondition.

Update a project alert rule

Alert Rule Collection

Alert Rule History

Alert Rule History Collection

The list of links to top-level resources and operations available from the root of the API.

The information about the assessment files that were added to the model.

Assessment Files

The association type describes an object, such as a model repository project, that will be associated with a workflow process.

Association

This is a base schema used to define paginated collections of resources. This base schema is extended by other schemas in APIs by adding an 'items' array property. These extensions define the application/vnd.sas.collection media type (version 2)

Base Collection

A collection of zero or more resource representations. Collections are often paginated and the items array contains one page of representations.

Collection

Contains information about the scored data and score execution job results.

Create Scored Data

Contains information about the execution status.

Execution Status

The key performance indicator (KPI) representations.

KPI Collection

Contains the metadata of the latest performance job.

Latest Performance Job

A link to a related operation or resource.

Link

Executable code generated by a score object using a score definition and input data. This represents application/vnd.sas.score.mapped.code media type (version 1).

Mapped Code

Model

Model File Content

Contains information about the model property.

Model Property

Multi-Variate Prediction Summary Request

Multi-Variate Prediction Summary Response

The output generated by the scoring job or analysis. This does not represent a top-level media type.

Output Table

Contains the performance health metrics for a model.

Performance Health Metrics

Contains information about the performance job.

Performance Job

Performance Job Collection

Contains summary information about the KPIs that are apart of a performance definition.

Performance KPI Summary

A collection of performance health metrics for a model.

Performance Metrics Collection

Contains summary information about a model that is part of a performance definition.

Performance Model Summary

Contains summary information about the time period for a performance definition.

Performance Period Summary

Contains information about the performance task.

Performance Task

Performance Task Collection

Contains information about the execution state of a performance task.

Performance Task Execution State

Contains summary information about the execution of a performance definition.

Performance Task Execution Summary

The project KPI defines the KPI key and value, and indicates whether the KPI is provided by the system o a custom KPI provided by a user.

Project KPI

Contains information about a published model.

Published Model

Contains information about publishing model content.

Publishing Model Content

Contains information about a publishing model request.

Publishing Model Request

Contains information about a report request.

Report Request

Contains information about the report response.

Report Response

Contains information about the resource collection.

Resource Collection

Request containing hints to generate mapped code using the Scoring Definition by Score Object.

Score Code Generation Request

Contains request information about how to generate a score execution job.

Score Execution Request

Contains information about the message that is updated.

Update Message

Contains information about the variable that is updated.

Update Variable

Contains information about the variables that are updated.

Update Variables

Contains information about the URI reference.

URI Reference

Variable

variableCollection

The workflow object association type describes an association between a Workflow process, that is managed by the Workflow service, and a solution object such as a Model Repository project. The association exists so that when a workflow process executes, the Model Repository service can know that a project or model has a workflow process using it. This enables the Model Repository service to lock certain functions or update object data based on workflow changes.

Workflow Association

The workflow object process type describes a workflow process task that is associated with SAS Model Manager. The process is managed by the Workflow service, but is used in SAS Model Manager to add workflow control to a model project.

Workflow Process

The workflow object process request type describes what is required to start a workflow process.

Workflow Process Request

The workflow object task type describes a workflow user task that is associated with a model project. The task is viewable only by a user who is an actual owner or potential owner of the task. Potential and actual task owners are defined in the workflow definition for a workflow process.


projectId	string	true	The ID of a project in the common model repository.
alertRuleId	string	true	The ID of the alert rule to update.

Name	Type	Required	Description
projectId	string	false	The ID of a project in the common model repository.
name	string	false	The name of the alert rule.
description	string	false	The description of the alert rule.
kpi	string	false	The name of the KPI.
severity	string	false	The severity of the KPI.
operator	string	false	The operator used for comparison. Operators such as greater than, less than, equal to, and so on.
value	number	false	The value of the KPI.
violations	integer	false	The number of violations.
modelRole	string	false	The role of a model.
triggered	boolean	false	Indicates whether the rule is triggered.
versionNum	integer	false	The version number of the rule.

Status	Meaning	Description
200	OK	The alert rule was updated successfully.	Headers	Schema
400	Bad Request	The request was invalid or the alert rule ID was not found.		Schema
404	Not Found	The project ID or alert rule ID is not valid.		Schema
412	Precondition Failed	The `If-Match` request header did not match the resource's entity tag (ETag).		Schema
428	Precondition Required	The request headers did not include a required `If-Match` or `If-Unmodified-Since` precondition.		Schema

Update a project alert rule

Request Samples

Response Samples

Path Parameters

Header Parameters

Request Body

Responses