---
title: "Create a data protection rule"
method: POST
path: "/msp/dataProtection/v1/rules"
tags: ["Data Protection"]
---

# Create a data protection rule

`POST /msp/dataProtection/v1/rules`

Creates a new data protection rule for the MSP.

## Headers

- `Authorization` string, required

## Request body

- DataProtectionCreateRuleRequest — CreateRuleRequest represents create rule API request
  - `evaluationFrequency` integer — Evaluation frequency: 0=N/A, 1=Hourly, 2=Daily, 3=Weekly, 4=Monthly
  - `parameterType` integer, required — Parameter type: 1=RPO Compliance, 2=Backup Success Rate, 3=Consecutive Failures
  - `productID` integer, required — Product ID: 1=Enterprise Workloads, 2=SaaS Apps and Endpoints
  - `ruleName` string, required — Rule name (3-255 characters, unique per MSP)
  - `status` integer, required — Rule status: 1=Active, 2=Disabled
  - `threshold` integer, required — Threshold value (depends on parameter_type)
  - `workloadIDs` integer[], required — Workload IDs to monitor

## Response `201`

Created

- DataProtectionCreateRuleResponse — RuleResponse represents single rule API response
  - `createdOn` string, date-time — When rule was created
  - `evaluationFrequency` integer — Evaluation frequency: 0=N/A, 1=Hourly, 2=Daily, 3=Weekly, 4=Monthly
  - `parameterType` integer — Parameter type: 1=RPO Compliance, 2=Backup Success Rate, 3=Consecutive Failures
  - `productID` integer — Product ID: 1=Enterprise Workloads, 2=SaaS Apps and Endpoints
  - `ruleID` string — Rule unique identifier
  - `ruleName` string — Rule name
  - `status` integer — Rule status: 1=Active, 2=Disabled
  - `threshold` integer — Threshold value
  - `updatedOn` string, date-time — When rule was last updated
  - `workloadIDs` integer[] — Workload IDs being monitored

## Other responses

- `400` — Bad Request - Invalid input or rule name already exists
- `401` — The request did not include a valid Access Token. Kindly provide a valid Access Token to process the request.
- `403` — Forbidden - Insufficient permissions
- `500` — The request was not processed due to an internal error. Kindly try again later. If the error persists, contact Druva Support.

---

[API](https://skmtc.net/druva/apis/authentication.md) · [All operations](https://skmtc.net/druva/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/druva/authentication/revisions/2af2bf148b25/schema)