---
title: "Approve an AI match-rule suggestion (create the rule)"
method: POST
path: "/v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/approve"
tags: ["Matching"]
---

# Approve an AI match-rule suggestion (create the rule)

`POST /v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/approve`

Approves a PENDING_REVIEW suggestion and creates the match rule through the deterministic configuration write path. This is the ONLY path from an AI suggestion to an active match rule, and it runs only on explicit human approval. The approving principal is recorded for audit. Tenant from the JWT, context from the path.

## Path parameters

- `contextId` string, uuid, required — Context ID
- `suggestionId` string, uuid, required — Suggestion ID

## Response `200`

OK

- ApproveRuleSuggestionResponse
  - `createdRuleId` string, required — Identifier of the match rule created from the approved suggestion
  - `reviewId` string, required — Identifier of the approved suggestion review

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)