Reject an AI match-rule suggestion (discard it)

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": "<string>"
}
'

import requests

url = "https://matcher.sandbox.lerian.net/v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/reject"

payload = { "reason": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({reason: '<string>'})
};

fetch('https://matcher.sandbox.lerian.net/v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/reject', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://matcher.sandbox.lerian.net/v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/reject",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'reason' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://matcher.sandbox.lerian.net/v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/reject"

	payload := strings.NewReader("{\n  \"reason\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://matcher.sandbox.lerian.net/v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/reject")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"reason\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://matcher.sandbox.lerian.net/v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/reject")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"reason\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "candidate": {
    "confidence": 123,
    "config": {},
    "priority": 123,
    "rationale": "<string>",
    "type": "<string>",
    "expectedImprovement": "<string>"
  },
  "contextId": "<string>",
  "createdAt": "<string>",
  "id": "<string>",
  "status": "<string>",
  "updatedAt": "<string>",
  "version": 123,
  "createdRuleId": "<string>",
  "rejectReason": "<string>",
  "reviewerId": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

POST

matching

contexts

{contextId}

rule-suggestions

{suggestionId}

reject

Reject an AI match-rule suggestion (discard it)

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": "<string>"
}
'

import requests

url = "https://matcher.sandbox.lerian.net/v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/reject"

payload = { "reason": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({reason: '<string>'})
};

fetch('https://matcher.sandbox.lerian.net/v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/reject', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://matcher.sandbox.lerian.net/v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/reject",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'reason' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://matcher.sandbox.lerian.net/v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/reject"

	payload := strings.NewReader("{\n  \"reason\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://matcher.sandbox.lerian.net/v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/reject")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"reason\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://matcher.sandbox.lerian.net/v1/matching/contexts/{contextId}/rule-suggestions/{suggestionId}/reject")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"reason\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "candidate": {
    "confidence": 123,
    "config": {},
    "priority": 123,
    "rationale": "<string>",
    "type": "<string>",
    "expectedImprovement": "<string>"
  },
  "contextId": "<string>",
  "createdAt": "<string>",
  "id": "<string>",
  "status": "<string>",
  "updatedAt": "<string>",
  "version": 123,
  "createdRuleId": "<string>",
  "rejectReason": "<string>",
  "reviewerId": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

Authorizations

Authorization

string

header

required

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

Path Parameters

contextId

string<uuid>

required

Context ID

suggestionId

string<uuid>

required

Suggestion ID

Body

application/json

reason

string

Optional rejection reason

Maximum string length: 1000

Example:

"too aggressive"

Response

candidate

object

required

The config-only proposed match rule

Show child attributes

contextId

string

required

Reconciliation context ID this suggestion belongs to

Example:

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

createdAt

string

required

When the review was created (RFC 3339)

Example:

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

string

required

Unique identifier for the review

Example:

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

status

string

required

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

Example:

"PENDING_REVIEW"

updatedAt

string

required

When the review was last updated (RFC 3339)

Example:

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

version

integer<int64>

required

Optimistic-concurrency version of the review

Example:

1

createdRuleId

string

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

Example:

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

rejectReason

string

Optional reason recorded when the suggestion is rejected

Example:

"too aggressive"

reviewerId

string

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

Example:

"user-42"

⌘I

Getting started

Configuration Contexts API

Configuration Match Rules API

Configuration Sources API

Configuration Field Maps API

Configuration Fee Schedules API

Configuration Fee Rules API

Configuration Schedules API

Exception workflow

Bulk actions

Comments

Callback credentials

Disputes API

Export Jobs API

Governance API

Ingestion jobs

Layouts and formats

Extraction reviews

Document extraction

Match runs

Manual matching and adjustments

Candidates and open items

Rule suggestions

Dashboard and metrics

Reports

Exports

Discovery status

Discovery connections

Extractions

Aggregator connections

Aggregator webhooks

Error handling

Reject an AI match-rule suggestion (discard it)

Authorizations

Path Parameters

Body

Response