---
title: "Process exception callback"
method: POST
path: "/v1/exceptions/{exceptionId}/callback"
tags: ["Exception"]
---

# Process exception callback

`POST /v1/exceptions/{exceptionId}/callback`

Use this endpoint to process a callback from an external system for a dispatched exception. This updates the exception status based on the external system resolution.

## Path parameters

- `exceptionId` string, required

## Headers

- `X-Request-Id` string
- `X-Idempotency-Key` string

## Request body

- ProcessCallbackRequest — Callback payload from an external system
  - `callbackType` string — Type of callback event
  - `externalSystem` string, required — Name of the external system sending the callback
  - `externalIssueId` string, required — Issue identifier in the external system
  - `status` string, required — Current status in the external system
  - `resolutionNotes` string — Notes from the external system resolution
  - `assignee` string — Current assignee in the external system
  - `dueAt` string, date-time — Due date from the external system
  - `updatedAt` string, date-time — Last update timestamp from the external system
  - `payload` object — Additional callback data from the external system

## Response `200`

Callback processed successfully.

The response includes the `X-Idempotency-Replayed` header.

If the value is false, the request was just processed. If the value is true, the response is a replay of a previously processed request.

See [Retries and idempotency](/en/reference/retries-idempotency) for more details.

- ProcessCallbackResponse — Acknowledgement of a processed callback
  - `status` string — Callback processing status

## Other responses

- `400` — The request contains invalid parameters or payload.
- `401` — The request lacks valid authentication credentials.
- `403` — You do not have permission to access this resource.
- `404` — Exception not found
- `409` — The request conflicts with the current state of the resource.
- `429` — Too many requests. The rate limit has been exceeded.
- `500` — An unexpected error occurred on the server.

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)