Cancel match

DEL https://api.invunion.com/api/v1/matches/:id matches:write Markdown

Delete a match.

Permanently deletes the match row. Invoice and transaction amounts are recalculated. A match.cancelled webhook is emitted. The path is the match UUID from List matches, not from the product.

To keep the row and only change status, use Update match with status cancelled. To undo an auto-match from the transaction code alone, use Reconcile transaction unlink_all.

See also

  • Matches . Which call to use for each change.
  • List matches (GET/api/v1/matches). Get the UUID by invoice number and transaction code.
  • Reconcile transaction (POST/api/v1/transactions/:code/reconcile). Cancel live matches on a bank line without a match UUID.
  • Update match (PUT/api/v1/matches/:id). Soft-cancel with status cancelled, or change the amount.

Path parameters

NameTypeRequired
id

Match UUID.

Example: 1c9e6679-7425-40de-944b-e07fc1f90ae7

string

No maximum

Required

Errors

This operation can return the following errors in addition to generic HTTP failures.

Error HTTP code Description
Missing Bearer token 401 The Authorization header is missing or is not a Bearer token.
Invalid or revoked API key 401 The API key is unknown, malformed, expired, or has been revoked.
API key is missing scope matches:write 403 The key does not include matches:write. A write scope does not imply the matching read scope.
Too many requests, please try again later 429 Wait and retry. The Retry-After header is the number of seconds to wait.
Match not found 404 No match with this UUID exists in the authenticated tenant.
Internal server error 500 Unexpected server error. The JSON body includes correlationId. Retry with backoff.
Previous: Update match Next: List ingest jobs