---
title: "Modify existing validation rule"
method: POST
path: "/api/v1/rules/modify-rules"
tags: ["Open API", "Rules"]
---

# Modify existing validation rule

`POST /api/v1/rules/modify-rules`

## Request

- Base URL: `https://developer.claimmind.life` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.claimmind.life/api/v1/rules/modify-rules`
- Auth: none declared. Required headers: `X-API-Key`

Update existing tenant-specific validation rules.

    **Use Case:** Adjust rule logic, severity, or requirements based on operational feedback.

    **Authentication:** API Key (X-API-Key header)
    **Required Scope:** `rules:write`

    **Request Structure:**
    - scope: "tenant"
    - rules: List of rules to modify (must include rule_id)

    **Modifiable Fields:**
    - requirement: Update description
    - severity: Change severity level (ERROR/WARNING/INFO)
    - applicability: Update logic
    - category: Update category

    **Example Request:**
    ```json
    {
        "scope": "tenant",
        "rules": [
            {
                "rule_id": "rule-uuid-123",
                "requirement": "Updated requirement text",
                "severity": "WARNING"
            }
        ]
    }
    ```

    **Example Response:**
    ```json
    {
        "success": True
    }
    ```

## Headers

- `X-API-Key` string, required

## Request body

- ModifyRuleRequest: Request schema for modifying rules.
  - `scope` 'system' | 'tenant', required: Rule scope enum.
  - `rules` ModifyRuleItem[], required
    - `rule_id` string, required
    - `ruleset_id` string, nullable
    - `applicability` Applicability, required: Rule applicability criteria.
      - `icd10_any` string[], nullable
      - `icd9_any` string[], nullable
      - `age_min` integer, nullable
      - `age_max` integer, nullable
      - `sex` 'M' | 'F' | 'any': Sex enum.
      - `care_type` CareType[], nullable
    - `requirement` string, required
    - `severity` 'error' | 'warning' | 'info' | 'any' | 'EPISODIC', required: Rule severity enum.
    - `category` 'Kriteria Diagnosis' | 'Tatalaksana' | 'Monitoring' | 'Indikasi Rawat Inap' | 'Kriteria Pulang' | 'Administratif' | 'Farmakologi' | 'Others', required: Rule category enum.
    - `activation_status` 'ACTIVE' | 'INACTIVE': Activation status enum.
    - `system_rule_id` string, nullable
    - `source` RuleSource: Source reference for a rule.
      - `page` string, nullable
      - `section` string, nullable
      - `title` string, nullable
    - `documents_to_validate` string[], nullable
    - `tenant_id` string, nullable

## Response `200`

Rule modified successfully

- unknown

## Other responses

- `400`: Invalid request
- `403`: Insufficient permissions
- `404`: Rule not found
- `422`: Validation Error

---

[API](https://skmtc.dev/claimmind/apis/claimmind-open-api-service.md) - [All operations](https://skmtc.dev/claimmind/apis/claimmind-open-api-service/llms.txt) - [OpenAPI document](https://skmtc.dev/claimmind/apis/claimmind-open-api-service/revisions/ee8bfbeadb8a?raw)