Skip to main content
POST
Bulk assign exceptions

Authorizations

Authorization
string
header
required

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

Headers

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, and an idempotency storage failure returns 500. These refusals are problem documents.

Body

application/json

Bulk assign payload

assignee
string
required

User to assign exceptions to

Required string length: 1 - 255
Example:

"user@example.com"

exceptionIds
string<uuid>[] | null
required

Exception IDs to assign

Required array length: 1 - 100 elements

Response

Bulk operation completed (check response for partial failures).

failed
object[] | null
required

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

succeeded
string[] | null
required

Identifiers (UUIDs) of exceptions that were processed successfully

total
integer<int64>
required

Total number of exceptions attempted (succeeded plus failed)

Example:

5