Bulk assign exceptions

Use this endpoint to assign multiple exceptions to a team member in a single operation. You can assign up to 100 exceptions at a time. An exception that is already assigned moves to the new assignee.

POST /v1/exceptions/bulk/assign

Bulk assign exceptions

cURL

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

200

Example

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

Autorizações

Authorization · string · header · obrigatório

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

Cabeçalhos

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.

Corpo

application/json

Bulk assign payload

assignee · string · obrigatório

User to assign exceptions to

Required string length: 1 - 255

Exemplo:

"[e-mail]"

exceptionIds · string<uuid>[] | null · obrigatório

Exception IDs to assign

Required array length: 1 - 100 elements

Resposta

200

application/json

Bulk operation completed (check response for partial failures).

failed · object[] | null · obrigatório

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

Show child attributes

succeeded · string[] | null · obrigatório

Identifiers (UUIDs) of exceptions that were processed successfully

total · integer<int64> · obrigatório

Total number of exceptions attempted (succeeded plus failed)

Exemplo:

5