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.

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

Reject an AI match-rule suggestion (discard it)

cURL

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/reject \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "too aggressive"
}
'

200

Example

{
  "candidate": {
    "confidence": 0.82,
    "config": {},
    "priority": 10,
    "rationale": "near-miss amounts cluster under 1%",
    "type": "TOLERANCE",
    "expectedImprovement": "+8% auto-match"
  },
  "contextId": "550e8400-e29b-41d4-a716-446655440000",
  "createdAt": "2026-06-16T10:30:00Z",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "PENDING_REVIEW",
  "updatedAt": "2026-06-16T10:35:00Z",
  "version": 1,
  "createdRuleId": "550e8400-e29b-41d4-a716-446655440000",
  "rejectReason": "too aggressive",
  "reviewerId": "user-42"
}

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication (format: "Bearer {token}")

Parámetros de ruta

contextId · string<uuid> · requerido

Context ID

suggestionId · string<uuid> · requerido

Suggestion ID

Cuerpo

application/json

reason · string

Optional rejection reason

Maximum string length: 1000

Ejemplo:

"too aggressive"

Respuesta

200

application/json

OK

candidate · object · requerido

The config-only proposed match rule

Show child attributes

contextId · string · requerido

Reconciliation context ID this suggestion belongs to

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

createdAt · string · requerido

When the review was created (RFC 3339)

Ejemplo:

"2026-06-16T10:30:00Z"

id · string · requerido

Unique identifier for the review

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

status · enum<string> · requerido

Lifecycle status: PENDING_REVIEW (awaiting human decision), APPROVED (rule created), or REJECTED (discarded)

Opciones disponibles: PENDING_REVIEW, APPROVED, REJECTED

Ejemplo:

"PENDING_REVIEW"

updatedAt · string · requerido

When the review was last updated (RFC 3339)

Ejemplo:

"2026-06-16T10:35:00Z"

version · integer<int64> · requerido

Optimistic-concurrency version of the review

Ejemplo:

1

createdRuleId · string

Identifier of the match rule created on approval; empty until an approved review is linked

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

rejectReason · string

Optional reason recorded when the suggestion is rejected

Ejemplo:

"too aggressive"

reviewerId · string

Principal id of the reviewer; empty until the suggestion is adjudicated

Ejemplo:

"user-42"