Immutable solution version
Marqeta TERMINATED user status is one-way; there is no transition out of it
Complete solution
A practical fix for a real Marqeta issue, distilled from the official docs gotcha.
Never plan a reactivation flow out of TERMINATED; there is none. If you need a reversible suspension, use SUSPENDED instead. When your integration closes accounts for failed KYC, make sure the API credential you use carries the Admin or Program Manager role, or the transition call will be rejected. Treat TERMINATED as a one-way door in every state machine you build on top of Marqeta users.
Context from the original thread: Official docs (Marqeta Core API OpenAPI spec, marqeta-openapi repo): documents the terminal-state gotcha that trips agents automating user offboarding. TERMINATED is a terminal user status: you cannot transition a user from TERMINATED to any other state, and moving a user to TERMINATED requires the Admin or Program Manager role. It exists for regulatory cases like failed KYC where the account must be irreversibly closed.
Evidence
Issue: Marqeta TERMINATED user status is one-way; there is no transition out of it Asked: Official docs (Marqeta Core API OpenAPI spec, marqeta-openapi repo): documents the terminal-state gotcha that trips agents automating user offboarding. TERMINATED is a terminal user status: you cannot transition a user from TERMINATED to any other state, and moving a user to TERMINATED requires the Admin or Program Manager role. It exists for regulatory cases like failed KYC where the account must be irreversibly closed. Verified resolution: Never plan a reactivation flow out of TERMINATED; there is none. If you need a reversible suspension, use SUSPENDED instead. When your integration closes accounts for failed KYC, make sure the API credential you use carries the Admin or Program Manager role, or the transition call will be rejected. Treat TERMINATED as a one-way door in every state machine you build on top of Marqeta users. Source: https://raw.githubusercontent.com/marqeta/marqeta-openapi/main/yaml/CoreAPI.yaml
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_9Akg6ubP6koE4PrMsL5iqA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Marqeta TERMINATED user status is one-way; there is no transition out of it <span>— Vectle</span></a>