---
title: "Update an operational exception's handling"
method: PATCH
path: "/audit/reports/exceptions/{intentId}/handling"
tags: ["Audit"]
---

# Update an operational exception's handling

`PATCH /audit/reports/exceptions/{intentId}/handling`

## Path parameters

- `intentId` string, required

## Request body

- union
  - object
    - `expectedObserved` union, required
      - object
        - `sourceType` 'intent', required
        - `sourceId` string, required
        - `category` 'blocked_denied_expired', required
        - `sourceStatus` 'blocked' | 'denied' | 'expired', required
      - object
        - `sourceType` 'transaction', required
        - `sourceId` string, required
        - `category` 'manual_review' | 'stale_provider_create' | 'failed_reversed', required
        - `sourceStatus` 'pending_create' | 'unknown' | 'manual_review' | 'failed' | 'reversed', required
      - object
        - `sourceType` 'wallet_transaction', required
        - `sourceId` string, required
        - `category` 'manual_review' | 'stale_wallet_lifecycle' | 'failed_reversed', required
        - `sourceStatus` 'prepared' | 'broadcast_pending' | 'broadcast' | 'reorged' | 'manual_review' | 'broadcast_failed' | 'rejected', required
    - `expectedHandlingUpdatedAt` string, date-time, nullable, required
    - `action` 'assign', required
    - `ownerMemberId` string, nullable, required
  - object
    - `expectedObserved` union, required
      - object
        - `sourceType` 'intent', required
        - `sourceId` string, required
        - `category` 'blocked_denied_expired', required
        - `sourceStatus` 'blocked' | 'denied' | 'expired', required
      - object
        - `sourceType` 'transaction', required
        - `sourceId` string, required
        - `category` 'manual_review' | 'stale_provider_create' | 'failed_reversed', required
        - `sourceStatus` 'pending_create' | 'unknown' | 'manual_review' | 'failed' | 'reversed', required
      - object
        - `sourceType` 'wallet_transaction', required
        - `sourceId` string, required
        - `category` 'manual_review' | 'stale_wallet_lifecycle' | 'failed_reversed', required
        - `sourceStatus` 'prepared' | 'broadcast_pending' | 'broadcast' | 'reorged' | 'manual_review' | 'broadcast_failed' | 'rejected', required
    - `expectedHandlingUpdatedAt` string, date-time, nullable, required
    - `action` 'start_review', required
  - object
    - `expectedObserved` union, required
      - object
        - `sourceType` 'intent', required
        - `sourceId` string, required
        - `category` 'blocked_denied_expired', required
        - `sourceStatus` 'blocked' | 'denied' | 'expired', required
      - object
        - `sourceType` 'transaction', required
        - `sourceId` string, required
        - `category` 'manual_review' | 'stale_provider_create' | 'failed_reversed', required
        - `sourceStatus` 'pending_create' | 'unknown' | 'manual_review' | 'failed' | 'reversed', required
      - object
        - `sourceType` 'wallet_transaction', required
        - `sourceId` string, required
        - `category` 'manual_review' | 'stale_wallet_lifecycle' | 'failed_reversed', required
        - `sourceStatus` 'prepared' | 'broadcast_pending' | 'broadcast' | 'reorged' | 'manual_review' | 'broadcast_failed' | 'rejected', required
    - `expectedHandlingUpdatedAt` string, date-time, nullable, required
    - `action` 'resolve', required
    - `disposition` 'action_completed' | 'reviewed_no_action', required
  - object
    - `expectedObserved` union, required
      - object
        - `sourceType` 'intent', required
        - `sourceId` string, required
        - `category` 'blocked_denied_expired', required
        - `sourceStatus` 'blocked' | 'denied' | 'expired', required
      - object
        - `sourceType` 'transaction', required
        - `sourceId` string, required
        - `category` 'manual_review' | 'stale_provider_create' | 'failed_reversed', required
        - `sourceStatus` 'pending_create' | 'unknown' | 'manual_review' | 'failed' | 'reversed', required
      - object
        - `sourceType` 'wallet_transaction', required
        - `sourceId` string, required
        - `category` 'manual_review' | 'stale_wallet_lifecycle' | 'failed_reversed', required
        - `sourceStatus` 'prepared' | 'broadcast_pending' | 'broadcast' | 'reorged' | 'manual_review' | 'broadcast_failed' | 'rejected', required
    - `expectedHandlingUpdatedAt` string, date-time, nullable, required
    - `action` 'dismiss', required
    - `disposition` 'duplicate' | 'not_actionable' | 'superseded', required
  - object
    - `expectedObserved` union, required
      - object
        - `sourceType` 'intent', required
        - `sourceId` string, required
        - `category` 'blocked_denied_expired', required
        - `sourceStatus` 'blocked' | 'denied' | 'expired', required
      - object
        - `sourceType` 'transaction', required
        - `sourceId` string, required
        - `category` 'manual_review' | 'stale_provider_create' | 'failed_reversed', required
        - `sourceStatus` 'pending_create' | 'unknown' | 'manual_review' | 'failed' | 'reversed', required
      - object
        - `sourceType` 'wallet_transaction', required
        - `sourceId` string, required
        - `category` 'manual_review' | 'stale_wallet_lifecycle' | 'failed_reversed', required
        - `sourceStatus` 'prepared' | 'broadcast_pending' | 'broadcast' | 'reorged' | 'manual_review' | 'broadcast_failed' | 'rejected', required
    - `expectedHandlingUpdatedAt` string, date-time, nullable, required
    - `action` 'reopen', required

## Response `200`

The exception's handling state after the action

- object
  - `changed` boolean, required
  - `handling` object, required
    - `status` 'unreviewed' | 'open' | 'in_review' | 'resolved' | 'dismissed', required
    - `disposition` 'action_completed' | 'reviewed_no_action' | 'duplicate' | 'not_actionable' | 'superseded', nullable, required
    - `ownerMemberId` string, nullable, required
    - `reviewed` object, nullable, required
      - `userId` string, required
      - `email` string, required
      - `role` 'admin' | 'operator' | 'viewer', required
      - `at` string, date-time, required
    - `resolved` object, nullable, required
      - `userId` string, required
      - `email` string, required
      - `role` 'admin' | 'operator' | 'viewer', required
      - `at` string, date-time, required
    - `updatedAt` string, date-time, nullable, required

---

[API](https://skmtc.dev/catena/apis/catena-api.md) · [All operations](https://skmtc.dev/catena/apis/catena-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/catena/catena-api/revisions/4cf035dc4837/schema)