> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Reject an AI match-rule suggestion (discard it) > Rejects a PENDING_REVIEW suggestion — nothing is created. The rejecting principal is recorded for audit. Tenant from the JWT, context from the path. ## OpenAPI ````yaml en/openapi/v3-current/matcher.yaml post /v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/reject openapi: 3.1.0 info: title: Matcher APIs description: >- Complete API reference for the Matcher reconciliation engine, providing automated transaction matching between Midaz Ledger and external systems. version: 4.1.0 license: name: Elastic License 2.0 url: https://www.elastic.co/licensing/elastic-license servers: - url: https://matcher.sandbox.lerian.net security: [] paths: /v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/reject: post: tags: - Matching summary: Reject an AI match-rule suggestion (discard it) description: >- Rejects a PENDING_REVIEW suggestion — nothing is created. The rejecting principal is recorded for audit. Tenant from the JWT, context from the path. operationId: rejectMatchRuleSuggestion parameters: - description: Context ID in: path name: contextId required: true schema: description: Context ID format: uuid type: string - description: Suggestion ID in: path name: suggestionId required: true schema: description: Suggestion ID format: uuid type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/RejectRuleSuggestionRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/RuleSuggestionResponse' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error security: - BearerAuth: [] components: schemas: RejectRuleSuggestionRequest: additionalProperties: false properties: reason: description: Optional rejection reason examples: - too aggressive maxLength: 1000 type: string type: object RuleSuggestionResponse: additionalProperties: false properties: candidate: $ref: '#/components/schemas/RuleSuggestionCandidateResponse' description: The config-only proposed match rule contextId: description: Reconciliation context ID this suggestion belongs to examples: - 550e8400-e29b-41d4-a716-446655440000 type: string createdAt: description: When the review was created (RFC 3339) examples: - '2026-06-16T10:30:00Z' type: string createdRuleId: description: >- Identifier of the match rule created on approval; empty until an approved review is linked examples: - 550e8400-e29b-41d4-a716-446655440000 type: string id: description: Unique identifier for the review examples: - 550e8400-e29b-41d4-a716-446655440000 type: string rejectReason: description: Optional reason recorded when the suggestion is rejected examples: - too aggressive type: string reviewerId: description: >- Principal id of the reviewer; empty until the suggestion is adjudicated examples: - user-42 type: string status: description: >- Lifecycle status: PENDING_REVIEW (awaiting human decision), APPROVED (rule created), or REJECTED (discarded) examples: - PENDING_REVIEW type: string updatedAt: description: When the review was last updated (RFC 3339) examples: - '2026-06-16T10:35:00Z' type: string version: description: Optimistic-concurrency version of the review examples: - 1 format: int64 type: integer required: - id - contextId - candidate - status - version - createdAt - updatedAt type: object Detail: additionalProperties: false properties: code: description: >- Stable, machine-readable domain error code scoped to the emitting service (format: -NNNN). examples: - ERR-0001 type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object RuleSuggestionCandidateResponse: additionalProperties: false properties: confidence: description: >- Advisor confidence in the suggestion, from 0.0 (lowest) to 1.0 (highest) examples: - 0.82 format: double type: number config: additionalProperties: {} description: >- Per-type rule configuration over the closed schema; the shape depends on the candidate type type: object expectedImprovement: description: >- Advisory note on the expected auto-match-rate effect; never a monetary figure examples: - +8% auto-match type: string priority: description: Proposed rule priority in the range 1..1000 (lower runs first) examples: - 10 format: int64 type: integer rationale: description: Short human-readable rationale for the suggestion examples: - near-miss amounts cluster under 1% type: string type: description: >- Proposed rule type from the closed vocabulary: EXACT (strict equality), TOLERANCE (within an amount band), or DATE_LAG (allowing a settlement-date offset) examples: - TOLERANCE type: string required: - type - priority - config - rationale - confidence type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: 'Bearer token authentication (format: "Bearer {token}")' ````