We’re experiencing a critical issue with our document approval workflow in ETQ Reliance 2021. The workflow consistently stalls after manager approval, and documents never progress to the final review stage.
Our REST API callback endpoint is configured to handle approval state transitions, but we’re seeing timeout errors in the logs. The OAuth2 token validation appears to be working initially, but the callback attempts aren’t being logged properly in the workflow audit trail.
POST /api/workflow/callback/approval
Authorization: Bearer eyJhbGc...
Response: 504 Gateway Timeout
We’ve checked the endpoint configuration and it’s accessible, but there’s no retry logic implemented. Has anyone dealt with callback timeouts in document approval workflows? We need to understand the proper retry mechanism and exponential backoff strategy for ETQ.
ETQ doesn’t have built-in retry logic for REST callbacks by default. You need to configure this explicitly in your workflow settings. Also, make sure your OAuth2 token validation isn’t adding significant latency. We moved our permission checks to an async process and just acknowledge the callback immediately, then process the validation separately. Cut our response time from 45 seconds to under 2 seconds.
I’ve seen this before. The 504 timeout suggests your callback endpoint might be taking too long to respond. ETQ’s workflow engine has a default timeout of 30 seconds for REST callbacks. Are you performing any heavy operations in your callback handler that might exceed this limit?
The missing audit trail is definitely a symptom of the timeout. ETQ’s workflow engine expects a 200 response within the timeout window to mark the callback as successful. I’d recommend implementing proper error handling on your endpoint as well - return appropriate HTTP status codes so ETQ can distinguish between temporary failures (503) and permanent errors (400).
For the audit logging issue - check if your callback endpoint is actually sending the success response back to ETQ before the timeout occurs. The workflow audit log only records successful callbacks. If your endpoint times out before responding with 200 OK, nothing gets logged even if the callback was partially processed.