Driftwatch

Plaid / Plaid API (2020-09-14) /

Breakingdirection flip: their tools call this safe

value can now return "IDENTITY_ERROR", "USER_ERROR"

What changed

Producer-side tools call this additive. It breaks exhaustive switches, strict parsers and generated client enums.

Affects this value on PlaidErrorType reachable from 273 operations.

New values: IDENTITY_ERROR, USER_ERROR.

can now return "IDENTITY_ERROR", "USER_ERROR"

Who is affected

Code that reads Plaid's PlaidErrorType objects, used by 273 Plaid operations.

Before and after

WhereBeforeAfter
PlaidErrorType"API_ERROR", "ASSET_REPORT_ERROR", "BANK_TRANSFER_ERROR", "CHECK_REPORT_ERROR", "CONSUMER_REPORT_ERROR", "INCOME_VERIFICATION_ERROR", "INSTITUTION_ERROR", "INVALID_INPUT", "INVALID_REQUEST", "INVALID_RESULT", "ITEM_ERROR", "MICRODEPOSITS_ERROR", "OAUTH_ERROR", "PARTNER_ERROR", "PAYMENT_ERROR", "RATE_LIMIT_EXCEEDED", "RECAPTCHA_ERROR", "SANDBOX_ERROR", "SIGNAL_ERROR", "TRANSACTIONS_ERROR", "TRANSACTION_ERROR", "TRANSFER_ERROR""API_ERROR", "ASSET_REPORT_ERROR", "BANK_TRANSFER_ERROR", "CHECK_REPORT_ERROR", "CONSUMER_REPORT_ERROR", "IDENTITY_ERROR", "INCOME_VERIFICATION_ERROR", "INSTITUTION_ERROR", "INVALID_INPUT", "INVALID_REQUEST", "INVALID_RESULT", "ITEM_ERROR", "MICRODEPOSITS_ERROR", "OAUTH_ERROR", "PARTNER_ERROR", "PAYMENT_ERROR", "RATE_LIMIT_EXCEEDED", "RECAPTCHA_ERROR", "SANDBOX_ERROR", "SIGNAL_ERROR", "TRANSACTIONS_ERROR", "TRANSACTION_ERROR", "TRANSFER_ERROR", "USER_ERROR"

Code that breaks

switch (response) {
  // existing branches …
  // no branch for "IDENTITY_ERROR"
  // no branch for "USER_ERROR"
  default:
    throw new Error("unexpected value");
}

Based on Plaid’s published API specification. How severity is decided.