--- title: "Update Incident SLA Rule" method: PUT path: "/incident-sla-rule/{id}" tags: ["Incident SLA Rule"] --- # Update Incident SLA Rule `PUT /incident-sla-rule/{id}` ## Request - Base URL: `https://oneuptime.com/api` - URL: `https://oneuptime.com/api/incident-sla-rule/{id}` - Auth: API key in header `APIKey` - TypeScript: (a function with typed inputs; its response is checked against the schema) Endpoint to update an existing Incident SLA Rule ## Path parameters - `id` string, uuid, required ## Request body - object - `data` IncidentSlaRuleUpdateSchema, required: Update schema for IncidentSlaRule model. Update - `criteria` object: Versioned conditions that determine whether this rule matches a resource. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `name` string: Name of this SLA rule. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `description` string: Description of this SLA rule. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `order` number: Where this rule sits in the list. Rules are evaluated from the top of the list down, lowest number first, and the first one that matches wins. A new rule is added to the end of the list. Setting a number another one already has puts it in that place, and the ones in the way move one place along to make room. In the dashboard, drag the rows to reorder them. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `isEnabled` boolean: Whether this SLA rule is enabled. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `responseTimeInMinutes` number: Target response time in minutes. This is the maximum time allowed before the incident must be acknowledged. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `resolutionTimeInMinutes` number: Target resolution time in minutes. This is the maximum time allowed before the incident must be resolved. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `atRiskThresholdInPercentage` number: Percentage of the deadline at which the SLA status changes to At Risk. For example, 80 means the status becomes At Risk when 80% of the time has elapsed. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `internalNoteReminderIntervalInMinutes` number: How often (in minutes) to automatically post internal notes to unresolved incidents. Internal notes are only visible to your team. For example, set to 30 to remind your team every 30 minutes to provide an update. Leave empty to disable. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `publicNoteReminderIntervalInMinutes` number: How often (in minutes) to automatically post public notes to unresolved incidents. Public notes are visible to external stakeholders on your status page. For example, set to 60 to post a status update every hour. Leave empty to disable. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `internalNoteReminderTemplate` string: The content of the automatic internal note posted to your team. Use variables like {{incidentTitle}}, {{elapsedTime}}, {{slaStatus}}, {{timeToResolutionDeadline}} to include dynamic incident data. If left empty, a default template will be used. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `publicNoteReminderTemplate` string: The content of the automatic public note shown on your status page. Use variables like {{incidentTitle}}, {{elapsedTime}}, {{slaStatus}}, {{timeToResolutionDeadline}} to include dynamic incident data. If left empty, a default template will be used. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `monitors` object[]: Only apply this SLA rule to incidents affecting these monitors. Leave empty to match incidents from any monitor. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `id` string - `incidentSeverities` object[]: Only apply this SLA rule to incidents with these severities. Leave empty to match incidents of any severity. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `id` string - `incidentLabels` object[]: Only apply this SLA rule to incidents that have at least one of these labels. Leave empty to match incidents regardless of labels. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `id` string - `monitorLabels` object[]: Only apply this SLA rule to incidents from monitors that have at least one of these labels. Leave empty to match incidents regardless of monitor labels. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `id` string - `incidentTitlePattern` string: Regular expression pattern to match incident titles. Leave empty to match any title. Example: 'CPU.*high' matches titles containing 'CPU' followed by 'high'. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `incidentDescriptionPattern` string: Regular expression pattern to match incident descriptions. Leave empty to match any description. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] ## Response `200` Updated successfully - object - `data` IncidentSlaRuleReadSchema: Read schema for IncidentSlaRule model. Read - `_id` string, uuid: ID of this object. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `createdAt` object: Date and Time when the object was created. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `updatedAt` object: Date and Time when the object was updated. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `deletedAt` object: Date and Time when the object was deleted. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `criteria` object: Versioned conditions that determine whether this rule matches a resource. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `projectId` string, uuid: ID of your OneUptime Project in which this object belongs. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [No access - you don't have permission for this operation] - `name` string, required: Name of this SLA rule. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `description` string: Description of this SLA rule. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `order` number: Where this rule sits in the list. Rules are evaluated from the top of the list down, lowest number first, and the first one that matches wins. A new rule is added to the end of the list. Setting a number another one already has puts it in that place, and the ones in the way move one place along to make room. In the dashboard, drag the rows to reorder them. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `isEnabled` boolean: Whether this SLA rule is enabled. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `responseTimeInMinutes` number: Target response time in minutes. This is the maximum time allowed before the incident must be acknowledged. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `resolutionTimeInMinutes` number: Target resolution time in minutes. This is the maximum time allowed before the incident must be resolved. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `atRiskThresholdInPercentage` number: Percentage of the deadline at which the SLA status changes to At Risk. For example, 80 means the status becomes At Risk when 80% of the time has elapsed. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `internalNoteReminderIntervalInMinutes` number: How often (in minutes) to automatically post internal notes to unresolved incidents. Internal notes are only visible to your team. For example, set to 30 to remind your team every 30 minutes to provide an update. Leave empty to disable. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `publicNoteReminderIntervalInMinutes` number: How often (in minutes) to automatically post public notes to unresolved incidents. Public notes are visible to external stakeholders on your status page. For example, set to 60 to post a status update every hour. Leave empty to disable. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `internalNoteReminderTemplate` string: The content of the automatic internal note posted to your team. Use variables like {{incidentTitle}}, {{elapsedTime}}, {{slaStatus}}, {{timeToResolutionDeadline}} to include dynamic incident data. If left empty, a default template will be used. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `publicNoteReminderTemplate` string: The content of the automatic public note shown on your status page. Use variables like {{incidentTitle}}, {{elapsedTime}}, {{slaStatus}}, {{timeToResolutionDeadline}} to include dynamic incident data. If left empty, a default template will be used. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `monitors` object[]: Only apply this SLA rule to incidents affecting these monitors. Leave empty to match incidents from any monitor. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `id` string - `incidentSeverities` object[]: Only apply this SLA rule to incidents with these severities. Leave empty to match incidents of any severity. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `id` string - `incidentLabels` object[]: Only apply this SLA rule to incidents that have at least one of these labels. Leave empty to match incidents regardless of labels. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `id` string - `monitorLabels` object[]: Only apply this SLA rule to incidents from monitors that have at least one of these labels. Leave empty to match incidents regardless of monitor labels. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `id` string - `incidentTitlePattern` string: Regular expression pattern to match incident titles. Leave empty to match any title. Example: 'CPU.*high' matches titles containing 'CPU' followed by 'high'. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `incidentDescriptionPattern` string: Regular expression pattern to match incident descriptions. Leave empty to match any description. Permissions - Create: [Project Owner, Project Admin, Create Incident SLA Rule], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [Project Owner, Project Admin, Edit Incident SLA Rule] - `createdByUserId` string, uuid: User ID who created this object (if this object was created by a User). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Incident Admin, Incident Member, Incident Viewer, Read Incident SLA Rule], Update: [No access - you don't have permission for this operation] ## Other responses - `400`: Bad request. This response indicates that the request was malformed or contained invalid data. - `401`: Unauthorized. This response indicates that the request requires user authentication. - `402`: Payment Required. This response indicates that the request requires payment or a valid subscription. - `403`: Forbidden. This response indicates that the server understood the request, but refuses to authorize it. - `404`: Not found. The record does not exist, belongs to another project, or is one you may not read - the same answer for each. - `405`: Project not found. This response indicates that the requested project does not exist or is not accessible. - `408`: Request Timeout. This response indicates that the server timed out waiting for the request. - `415`: Unable to reach server. This response indicates that the server is currently unreachable or down. - `422`: Not authorized. This response indicates that the user does not have permission to access the requested resource. - `500`: Internal Server Error. This response indicates that the server encountered an unexpected condition that prevented it from fulfilling the request. --- [API](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification.md) - [All operations](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/revisions/ba3307d00304?raw)