Revenue
Admin force refresh Decision Explanation Card
ADMIN-only (SUPER_ADMIN, ORG_ADMIN). Rate-limited to once per minute per call. Synchronously runs DECISION_EXPLANATION_REFRESH via DecisionExplanationJobHandler (creates a JobRun and awaits DecisionExplanationAssemblyService.assemble). AuditLog + decision.explanation.refreshed are written only after the JobRun succeeds. Requires EXPLAINABLE_DECISION_ENGINE_ENABLED=true (503 when off). Returns 409 when a refresh is already in progress for the call. Cross-tenant or missing call returns 404. Never mutates M7–M13 domain outcomes.
https://api.thearvexa.com/api/calls/{id}/decision-explanation/refreshCalls
Recent Requests
Log in to see full request history| Time | Status | User Agent |
|---|---|---|
| Make a request to see history. | ||
Path Params
idstringrequiredHeaders
x-organization-idstringrequiredTenant organization identifier
x-user-rolestringrequiredDevelopment RBAC role (for example SUPER_ADMIN, ORG_ADMIN, OPS_MANAGER, VIEWER)
x-user-idstringTrusted authenticated actor id (interim header auth). Recorded as the actor on sensitive writes such as finance adjustments and their approve/reject decisions. Ignored when header auth is disabled.
Responses
200Refresh JobRun completed synchronouslyapplication/json
Refresh JobRun completed synchronously
Schema
okbooleanrequireddecisionExplanationIdstringrequiredcallIdstringrequiredorganizationIdstringrequiredjobRunIdstringrequiredstatusenum(PENDING | READY | PARTIAL | FAILED | STALE)requiredcreatedbooleanrequiredTrue when assemble created a new DecisionExplanation row.
eventsEmittedarrayrequiredIncludes decision.explanation.refreshed when audit/event persisted.
itemsstringExample
{
"ok": true,
"decisionExplanationId": "string",
"callId": "string",
"organizationId": "string",
"jobRunId": "string",
"status": "PENDING",
"created": true,
"eventsEmitted": [
"string"
]
}400Validation error
Validation error
No response body schema in OpenAPI
This status is documented, but the operation did not publish a response schema or example. The HTTP status and description above are still authoritative.
403Forbidden for the supplied role
Forbidden for the supplied role
No response body schema in OpenAPI
This status is documented, but the operation did not publish a response schema or example. The HTTP status and description above are still authoritative.
404Resource not found
Resource not found
No response body schema in OpenAPI
This status is documented, but the operation did not publish a response schema or example. The HTTP status and description above are still authoritative.
409Decision explanation refresh already in progress
Decision explanation refresh already in progress
No response body schema in OpenAPI
This status is documented, but the operation did not publish a response schema or example. The HTTP status and description above are still authoritative.
429Refresh rate limit exceeded (1/min/call)
Refresh rate limit exceeded (1/min/call)
No response body schema in OpenAPI
This status is documented, but the operation did not publish a response schema or example. The HTTP status and description above are still authoritative.