List AI match-rule suggestions (the human-review queue)

Cursor-paginated list of rule suggestions for a context, optionally filtered by status (e.g. PENDING_REVIEW). Reads stored config-only candidates; egresses nothing. Tenant from the JWT, context from the path.

GET /v1/matching/contexts/{contextId}/rule-suggestions

List AI match-rule suggestions (the human-review queue)

cURL

curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/matching/contexts/{contextId}/rule-suggestions \
  --header 'Authorization: Bearer <token>'

200

Example

{ "items": [ { "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" } ], "limit": 20, "nextCursor": "eyJpZCI6IjEyMyJ9", "prevCursor": "eyJpZCI6IjEyMiJ9" }

Autorizaciones

Authorization · string · header · requerido

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

Parámetros de ruta

contextId · string<uuid> · requerido

Context ID

Parámetros de consulta

status · enum<string>

Filter by status

Opciones disponibles: PENDING_REVIEW, APPROVED, REJECTED

limit · integer<int64>

Page size

Rango requerido: 1 <= x <= 200

cursor · string

Opaque pagination cursor

Respuesta

200

application/json

OK

items · object[] | null · requerido

Page of rule-suggestion reviews

Show child attributes

limit · integer<int64> · requerido

Maximum number of items requested for this page

Ejemplo:

20

nextCursor · string

Opaque cursor for the next page; empty when there are no more results

Ejemplo:

"eyJpZCI6IjEyMyJ9"

prevCursor · string

Opaque cursor for the previous page; empty on the first page

Ejemplo:

"eyJpZCI6IjEyMiJ9"