---
title: "PATCH /{resourceUri}/providers/Microsoft.BillingTrust/assessments/default/rules/{ruleName}"
method: PATCH
path: "/{resourceUri}/providers/Microsoft.BillingTrust/assessments/default/rules/{ruleName}"
tags: ["Rules"]
---

# PATCH /{resourceUri}/providers/Microsoft.BillingTrust/assessments/default/rules/{ruleName}

`PATCH /{resourceUri}/providers/Microsoft.BillingTrust/assessments/default/rules/{ruleName}`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/{resourceUri}/providers/Microsoft.BillingTrust/assessments/default/rules/{ruleName}`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

Update a Rule. The PATCH body is discriminated by `kind` and must match the existing rule's kind. For `eduQualification` rules, only `supplementalDocuments` is patchable, and only when `evaluationState == actionRequired`. For `businessVerification` rules, the patchable fields are `supplementalDocuments` and `externalId`, and only when `evaluationState` is `pending` or `actionRequired`. All other field/state combinations are rejected with 400 InvalidParameterValue or 409 RuleNotActionable.

## Path parameters

- `resourceUri` string, required
- `ruleName` string, required

## Parameters

- `../../../../../../common-types/resource-management/v6/types.json#/components/parameters/ApiVersionParameter` (unresolved $ref)

## Request body

- RulePatchProperties: Patch body for updating a rule. Polymorphic by `kind` — kind-specific patchable fields live on per-kind subtypes. PATCH cannot change a rule's kind; the discriminator carries the rule's existing kind for routing only.
  - `kind` 'eduQualification' | 'businessVerification', required: The kind of rule. Additional kinds may be added in future API versions.

## Response `200`

Azure operation completed successfully.

- Rule (unresolved $ref)

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/azure/apis/billingtrust-management-api.md) - [All operations](https://skmtc.dev/azure/apis/billingtrust-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/billingtrust-management-api/revisions/d80eb2ee5211?raw)