- Introduction
- Getting started
- Process modeling with BPMN
- Process modeling with Case Management
- Designing a persistent case entity schema
- Defining case keys (system vs. external)
- Establishing task I/O and write-back contracts
- Exit rules and early stage termination
- Modeling primary and secondary stages
- Triggering a case from Data Fabric
- Implementing stage-level personas and permissions
- Setting SLAs and automated escalation rules
- Configuring a rework loop (re-entry)
- Managing live case instances: pause, migrate, and retry
- Maestro case management component dictionary
- Process implementation
- Debugging
- Simulating
- Publishing and upgrading agentic processes
- Common implementation scenarios
- Extracting and validating documents
- Process operations
- Process monitoring
- Process optimization
- Reference information
Maestro user guide
Overview
Configure case-level and stage-level SLAs (Service Level Agreements) in Maestro Case to enforce time-based completion targets. Define at-risk and breach escalation rules that listen for the internal *SlaAtRisk and *SlaBreached events emitted by the case lifecycle and automatically notify stakeholders, reassign work, or flag overdue cases — without manual monitoring.
Prerequisites
- Access to Studio Web.
- An existing case plan with at least one stage defined. See Create a case and model stages for setup instructions.
- A published and deployed case plan if you want to observe SLA indicators at runtime in the Case App or Case Instance Management.
- Familiarity with stage rules (entry, complete, exit, and re-entry).
Step 1: configuring a case-level SLA
A case-level SLA defines the overall target time for resolving a case from creation to close.
Opening the case plan settings
- Open your case project in Studio Web.
- Navigate to the Case Plan Designer canvas.
- Open the case-level settings panel for your case type.
Setting the case SLA duration
-
Locate the SLA section in the case settings.
-
Define the target resolution time (for example,
48business hours or a calendar-day equivalent). -
Save the configuration.
The case-level SLA timer starts when the case instance is created and stops when the case reaches a terminal state (completed or cancelled).
Step 2: configuring stage-level SLAs
Stage-level SLAs set localized due times for individual phases of the case. Each stage can have its own SLA independent of the overall case target.
Selecting a stage on the canvas
- On the Case Plan Designer canvas, select the stage you want to configure (for example, Intake or Review).
- Open the stage properties panel.
Defining the stage SLA
-
In the stage properties, locate the SLA field.
-
Enter the time limit for stage completion. Specify whether the duration uses business days or calendar days (for example,
4hours for an Intake stage,24hours for a Review stage). -
Repeat for each stage that requires its own SLA.
Example stage SLA configuration
| Stage | SLA Duration | Description |
|---|---|---|
| Intake | 4 hours | Ensure rapid claim registration after submission |
| Review | 24 hours | Complete coverage check and officer verification |
| Settlement | 48 hours | Process fulfilment and issue payment |
| Closure | 8 hours | Generate audit report and finalize the case |
Step 3: defining at-risk escalation rules
At-risk escalations are rules that fire on internal SLA events emitted by the case lifecycle. When the timer crosses the at-risk threshold, the runtime emits a CaseSlaAtRisk event (or StageSlaAtRisk for stage-level SLAs); your escalation rule listens for that event and runs the configured action.
Opening escalation rule configuration
- In the stage (or case) properties panel, locate the Escalations section.
- Select the option to add an escalation rule for the At-risk state.
Setting the at-risk threshold
- Define the warning threshold as a percentage of the allotted SLA time (for example,
80%). When the timer reaches this threshold, the SLA state changes from on-track to at-risk and the corresponding*SlaAtRiskevent fires.
Configuring the at-risk rule (WHEN / IF / ACTION)
- Confirm the WHEN event:
CaseSlaAtRisk(case-level) orStageSlaAtRisk(stage-level). - Optionally add an IF condition over the case entity to scope the rule (for example,
IF case.priority == "High"). - Specify the ACTION to execute when the rule fires. Typical at-risk actions include:
- Notify the case owner and supervisor.
- Flag the case with an at-risk badge visible in the Case App list view.
- Define the recipients who receive the at-risk notification.
- Save the escalation rule.
Step 4: defining breach escalation rules
Breach escalations are rules that fire on the CaseSlaBreached / StageSlaBreached internal events, emitted when the SLA timer expires.
Adding a breach escalation rule
- In the same Escalations section, select the option to add an escalation rule for the Breached state.
Configuring the breach rule (WHEN / IF / ACTION)
- Confirm the WHEN event:
CaseSlaBreached(case-level) orStageSlaBreached(stage-level). - Optionally add an IF condition (for example,
IF case.amount >= 50000to scope the rule to high-value cases). - Specify the ACTION to execute on SLA breach. Typical breach actions include:
- Reassign the case or task to a senior worker.
- Notify management.
- Create a priority flag on the case instance.
- Define the recipients who receive the breach notification.
- Save the escalation rule.
Step 5: using pause and resume to manage SLA timers
Pause SLA timers when the case is waiting on external input (for example, a customer response). Resume the timers when the case becomes actionable again.
Pausing a running case instance
- Open Case Instance Management in Maestro.
- Locate the running case instance.
- Select Pause. All SLA timers on the case stop, and no tasks are activated until the case is resumed.
Resuming a paused case instance
- In Case Instance Management, locate the paused case instance.
- Select Resume. SLA timers restart from where they stopped.
- Pause and Resume are operator-level actions available in Case Instance Management.
- SLA timers resume from the elapsed point — they do not reset to zero.
Step 6: validating and publishing
- Review all SLA and escalation configurations across the case and each stage.
- Validate the case plan in Studio Web to check for configuration errors.
- Publish the case plan and deploy it to the target folder.
- Verify the deployment in Case Instance Management.
Expected outcome
After completing these steps:
- Case-level SLA enforces an overall resolution deadline from case creation to close.
- Stage-level SLAs enforce localized time limits for each phase of the case lifecycle.
- SLA state badges (on-track, at-risk, breached) display in the Case App list view and case detail view, giving case workers and supervisors immediate visibility.
- At-risk escalation rules automatically notify designated recipients when SLA timers approach their limits.
- Breach escalation rules automatically reassign, flag, or notify when SLA timers expire.
- Pause/Resume controls allow operators to suspend SLA timers during periods of external dependency.
Use case example
Scenario: Property insurance claims processing with four stages.
| Level | SLA Target | At-Risk Threshold | At-Risk Action | Breach Action |
|---|---|---|---|---|
| Case | 48 business hours | 80% (≈ 38.4 hours) | Notify case owner and supervisor | Notify management, create priority flag |
| Intake | 4 hours | 80% (≈ 3.2 hours) | Notify intake team lead | Reassign to senior intake worker |
| Review | 24 hours | 80% (≈ 19.2 hours) | Notify claims officer | Reassign to senior adjuster, notify management |
| Settlement | 12 hours | 80% (≈ 9.6 hours) | Notify settlement team lead | Escalate to finance manager |
In this configuration, if the Review stage runs for more than 19.2 hours, the at-risk rule notifies the claims officer. If the stage exceeds 24 hours, the breach rule reassigns the case to a senior adjuster and notifies management.
Troubleshooting
| Issue | Possible Cause | Resolution |
|---|---|---|
| SLA badges do not appear in the Case App | The case plan was published before SLA configuration was added | Republish the case plan with SLA settings and redeploy |
| At-risk notification not triggered | The at-risk threshold percentage is set too high (for example, 99%) | Lower the threshold to a practical value such as 80% |
| SLA timer continues while case is blocked on external input | The case instance was not paused | Use Pause in Case Instance Management to suspend the SLA timer |
| SLA timers reset to zero after resume | Unexpected behavior — timers should resume from the elapsed point | Contact UiPath Support if this occurs, as this may indicate a platform issue |
| Breach escalation does not reassign the task | No recipient or reassignment target was configured in the breach rule | Edit the breach escalation rule and specify the target worker or team |
Limitations
- SLA and escalation configuration is performed at the case level and stage level. Individual task-level SLAs are not covered in this guide.
- Case user roles and access support (stage-aware permissions that control who receives escalation actions) is not yet available.
- SLA tracking applies only to case instances created after the SLA-enabled case plan version is deployed.
Next steps
- How to configure stage rules — define entry, complete, exit, and re-entry rules that work alongside SLA timers.
- Case Instance Management overview — learn about pause, resume, cancel, migrate, and retry operations for running cases.
- Configure the Case App — customize the case list and detail views where SLA badges appear for case workers and supervisors.
- Overview
- Prerequisites
- Step 1: configuring a case-level SLA
- Opening the case plan settings
- Setting the case SLA duration
- Step 2: configuring stage-level SLAs
- Selecting a stage on the canvas
- Defining the stage SLA
- Example stage SLA configuration
- Step 3: defining at-risk escalation rules
- Opening escalation rule configuration
- Setting the at-risk threshold
- Configuring the at-risk rule (WHEN / IF / ACTION)
- Step 4: defining breach escalation rules
- Adding a breach escalation rule
- Configuring the breach rule (WHEN / IF / ACTION)
- Step 5: using pause and resume to manage SLA timers
- Pausing a running case instance
- Resuming a paused case instance
- Step 6: validating and publishing
- Expected outcome
- Use case example
- Troubleshooting
- Limitations
- Next steps