Change an application's stage. Optionally approve it and continue its flow, the same way Approve works on the Agent Dashboard.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Default: set the stage only
Without rerun_flow, this call only changes the application's stage and adds an entry to its activity, for example "Application is set to Review using Update Status API." It does not run decision trees or providers, send emails or fire webhooks. Setting stage 1 (Approved) or 2 (Declined) this way changes only the stage label; the application is not approved or declined.
Approve and continue the flow (rerun_flow)
Send stage: 1 with rerun_flow: true to approve the application the same way Approve works on the Agent Dashboard. Any approve_variable_data is merged into the application first. If the application was in review or document request and the chosen outcome has a child decision tree, that tree runs; otherwise the flow continues from the current step. The application.approved webhook fires when the application ends up approved.
Environment and access
A key that starts with live_ updates live applications; any other key (for example test_) updates sandbox applications. An application from the other environment returns Invalid App Id. The application must belong to the same account as your API key, or the call returns 403.
An invalid or inactive Bearer token. No response body is returned. A request with no Authorization header is 403, not 401.