Reconciliation Operations
You can interact with the reconciliation engine over REST, as shown in the following table:
| URI | HTTP Operation | Description |
|---|---|---|
| /openidm/recon | GET | Lists all reconciliation runs, including those in progress. Inspect the state property to see the reconciliation status. |
| /openidm/recon?_action=recon&mapping=mapping-name | POST | Launches a reconciliation run with the specified mapping. |
| /openidm/recon?_action=reconById&mapping=mapping-name&id=id | POST | Restricts the reconciliation run to the specified ID. |
| /openidm/recon/id?_action=cancel | POST | Cancels the specified reconciliation run. |
The following example runs a reconciliation action, with the mapping systemHrdb_managedUser, as defined in sync.json:
curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Accept-API-Version: resource=1.0" \
--request POST \
"http://localhost:8080/openidm/recon?_action=recon&mapping=systemHrdb_managedUser"