FurniOpsDocs
API referenceMatching

Dismiss a review pair

Records that the two are different items: the pair is not offered again, however they are scored later. A pair that is not open answers 409.

POST/v1/match-pairs/{id}/dismiss

Records that the two are different items: the pair is not offered again, however they are scored later. A pair that is not open answers 409.

Authorization

apiKey
AuthorizationBearer <token>

An API key (fo_live_… / fo_test_…) as a bearer token

In: header

Path Parameters

id*string

Match pair (two variants matching offers for review) ID

Match^mpr_[0-9A-Za-z]{22}$

Header Parameters

FurniOps-Version?string

Dated API version; pinned per organisation on first use and overridable per request

Value in

  • "2026-10-01"
  • "2026-10-04"
FurniOps-Mode?string

The data the request acts on: test is the organisation's sandbox. An OAuth token picks it (live by default); an API key's mode is fixed, and naming the other one is refused

Value in

  • "live"
  • "test"
Idempotency-Key*string

Unique key for this operation, reused on retries (24 h)

Length1 <= length <= 257
FurniOps-Dry-Run?string

Preview the write and change nothing: true answers the would-be response, explain a Preview (application/vnd.furniops.preview+json)

Value in

  • "true"
  • "explain"

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/match-pairs/string/dismiss" \  -H "Idempotency-Key: string"
{  "object": "match_pair",  "id": "string",  "status": "open",  "probability": 0,  "variants": [    {      "id": "string",      "product": "string"    },    {      "id": "string",      "product": "string"    }  ],  "evidence": [    {      "comparison": "string",      "level": -9007199254740991,      "weight": 0    }  ],  "conflicts": [    "string"  ],  "judgement": {    "object": "match_judgement",    "id": "string",    "model": "string",    "outcome": "merged",    "choice": "string",    "confidence": 0,    "reasons": [      {        "field": "string",        "subject_quote": "string",        "candidate_quote": "string"      }    ],    "note": "string",    "judged_at": "2019-08-24T14:15:22Z"  },  "merge": "string",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z"}

Set a source's category rules POST

Sets or removes the rules given; other rules stay as they are. A rule covers its path and every path below it until a more specific rule. The source's current snapshot is replayed to apply them. An unknown category answers 422; a source with an active run, or a paused or disabled one, answers 409, and then nothing is saved.

Retrieve the AI judge's settings GET

Whether the AI judge looks at the organisation's review pairs, its daily budget and how much of it was used, the confidence at which it merges, and the model it asks.