Diagnose and repair bank account ledger mappings

curl -G https://api-staging.openledger.com/v1/banks/diagnose-ledger-accounts \
     -H "Authorization: Bearer <token>" \
     -d entityId=ent_123456 \
     -d repair=true

{
  "summary": {
    "total": 3,
    "healthy": 1,
    "missing_ledger_account_id": 1,
    "broken_reference": 1,
    "repaired": 2,
    "errors": 0
  },
  "accounts": [
    {
      "plaidAccountId": "acc_123",
      "accountName": "Chase Checking",
      "accountMask": "1234",
      "hasLedgerAccountId": true,
      "ledgerAccountId": "ledger_456",
      "ledgerAccountExists": true,
      "status": "healthy"
    },
    {
      "plaidAccountId": "acc_789",
      "accountName": "Wells Fargo Savings",
      "accountMask": "5678",
      "hasLedgerAccountId": false,
      "ledgerAccountId": "ledger_999",
      "ledgerAccountExists": true,
      "status": "repaired_new"
    }
  ],
  "repairMode": true,
  "message": "Diagnostic completed with repair attempts"
}

Diagnoses bank accounts that are missing corresponding ledger accounts and optionally repairs them. This is useful when bank accounts were created but their ledger accounts were not properly set up.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

entityIdstringRequired

The ID of the entity to diagnose

repairenumOptional

Set to "true" to attempt automatic repair of missing ledger accounts

Allowed values:

Response

Diagnostic completed successfully

summaryobject

accountslist of objects

repairModeboolean

Whether repair mode was enabled

messagestring

Summary message about the diagnostic results

Errors

400

Bad Request Error

500

Internal Server Error