Saltar al contenido principal
POST
Process exception callback

Autorizaciones

X-Callback-Token
string
header
requerido

Opaque bearer token authenticating an external system's inbound exception callback.

Encabezados

X-Callback-Token
string
requerido

Opaque bearer token authenticating the external system

X-Idempotency
string
requerido

Idempotency key for deduplication

Parámetros de ruta

exceptionId
string<uuid>
requerido

The unique identifier of the exception. Exception ID (UUID)

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

Cuerpo

application/json

Callback payload from external system

assignee
string
requerido

Assignee identifier (required when status is ASSIGNED)

Ejemplo:

"user@example.com"

callbackType
string
requerido

Type of callback (e.g. status_update, assignment)

Ejemplo:

"status_update"

dueAt
string | null
requerido

Due date for resolution as an RFC 3339 timestamp

Ejemplo:

"2025-01-20T10:30:00Z"

externalIssueId
string
requerido

Issue ID in the external system

Minimum string length: 1
Ejemplo:

"RECON-1234"

externalSystem
string
requerido

External system identifier (e.g. JIRA, SERVICENOW, WEBHOOK)

Minimum string length: 1
Ejemplo:

"JIRA"

payload
object
requerido

Arbitrary payload from the external system

resolutionNotes
string
requerido

Optional resolution notes

Ejemplo:

"Resolved by external agent"

status
string
requerido

Target status for the exception (e.g. ASSIGNED, RESOLVED)

Minimum string length: 1
Ejemplo:

"RESOLVED"

updatedAt
string | null
requerido

External system timestamp as an RFC 3339 timestamp

Ejemplo:

"2025-01-15T10:30:00Z"

Respuesta

Callback processed successfully.

status
string
requerido

Processing status of the callback (the handler always returns "accepted" on success)

Ejemplo:

"accepted"