Bulk resolve exceptions

Use this endpoint to resolve multiple exceptions in a single operation. You can resolve up to 100 exceptions at a time with a shared resolution and reason.

POST /v1/exceptions/bulk/resolve

Bulk resolve exceptions

cURL

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/exceptions/bulk/resolve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "exceptionIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "resolution": "ACCEPTED",
  "reason": "Variance within tolerance"
}
'

200

Example

{
  "failed": [
    {
      "error": "exception not found",
      "exceptionId": "550e8400-e29b-41d4-a716-446655440000",
      "code": "MTCH-0514"
    }
  ],
  "succeeded": [
    "<string>"
  ],
  "total": 5
}

Autorizaciones

Authorization · string · header · requerido

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

Encabezados

X-Request-Id · string

A unique identifier for tracing the request across services.

X-Idempotency · string

Optional idempotency key for safe retries. Matcher reads the key only from this header, and only when you send one. A request that carries a key only in X-Idempotency-Key or Idempotency-Key is refused with 400 (MTCH-0015), and nothing is processed. If the same key is sent again and the original request was already processed, the stored response is returned with X-Idempotency-Replayed: true. A malformed key returns 400, a key whose first request is still in progress returns 409 (MTCH-0018), a key whose earlier attempt already ran but whose answer cannot be replayed returns 409 (MTCH-0022), and an idempotency storage failure returns 500. POST, PUT, PATCH and DELETE requests accept the header. These refusals are problem documents.

Cuerpo

application/json

Bulk resolve payload

exceptionIds · string<uuid>[] | null · requerido

Exception IDs to resolve

Required array length: 1 - 100 elements

resolution · string · requerido

Resolution type applied

Required string length: 1 - 255

Ejemplo:

"ACCEPTED"

reason · string

Optional reason for the resolution

Maximum string length: 1000

Ejemplo:

"Variance within tolerance"

Respuesta

200

application/json

Bulk operation completed (check response for partial failures).

failed · object[] | null · requerido

Per-exception failures for the items that could not be processed

Show child attributes

succeeded · string[] | null · requerido

Identifiers (UUIDs) of exceptions that were processed successfully

total · integer<int64> · requerido

Total number of exceptions attempted (succeeded plus failed)

Ejemplo:

5