---
title: "Break/Unmatch a match group"
method: DELETE
path: "/v1/matching/groups/{matchGroupId}"
tags: ["Matching"]
---

# Break/Unmatch a match group

`DELETE /v1/matching/groups/{matchGroupId}`

Use this endpoint to break an incorrect match group. This rejects the match with a reason and reverts all associated transactions to UNMATCHED status.

## Path parameters

- `matchGroupId` string, required

## Query parameters

- `contextId` string, required

## Headers

- `X-Request-Id` string

## Request body

- UnmatchRequest
  - `reason` string, required

## Response `204`

Indicates that the operation was successful with no content to return.

## Other responses

- `400` — The request contains invalid parameters or payload.
- `401` — The request lacks valid authentication credentials.
- `403` — You do not have permission to access this resource.
- `404` — The requested resource was not found.
- `500` — An unexpected error occurred on the server.

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)