Incidentes

Um Incident é aberto quando uma ExecutableTask esgota suas tentativas de retry, ou quando um erro de negócio não tem BOUNDARY_ERROR_HANDLER correspondente (ver Retry e Resiliência e Tratando Erros de Negócio).

Operação	Endpoint
Buscar um incidente por id	GET /incidents/{id}
Retentar um incidente aberto	PUT /incidents/{id}/retry
Incidentes de uma instância	GET /process-instances/{id}/incidents (ver Instâncias de Processo)

GET /incidents/{id} requer QueryRepository; PUT /incidents/{id}/retry requer KikwiflowEngine.

Buscar por id

GET /incidents/{id}

200 OK com o Incident completo, ou 404 (NOT_FOUND).

Campo	Papel
id	Identificador do incidente.
type	FAILED_JOB (a tarefa esgotou as retentativas numa exceção técnica) ou UNHANDLED_BUSINESS_ERROR (um ProcessErrorException sem BOUNDARY_ERROR_HANDLER correspondente).
message / stackTrace	Detalhe do erro capturado.
processDefinitionId / processInstanceId	Onde o incidente ocorreu.
taskDefinitionId	id do nó na definição — cruza com o diagrama.
executionId	id da ExecutableTask que falhou — é o que retry reativa.
status	OPEN ou RESOLVED.
createdAt	Quando o incidente foi aberto.

Retentar

PUT /incidents/{id}/retry

Sem corpo. Reativa a ExecutableTask associada (status → PENDING, retries restaurado ao máximo — o declarado na retryPolicy do próprio nó, ou 3 se o nó não declarar uma política própria — esse default não é configurável por propriedade kikwiflow.*) e marca o incidente como RESOLVED, de forma atômica. Resposta 204 No Content.

Situação	Resultado
id inexistente	404 (NOT_FOUND)
Incidente existe mas não está OPEN (já RESOLVED)	409 (CONFLICT) — só incidentes OPEN podem ser retentados
ExecutableTask associada não existe mais (ex.: instância apagada via PUT /process-instances/{id})	404 (NOT_FOUND)