Solution skill
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.
Marqeta TERMINATED user status is one-way; there is no transition out of it
TL;DR
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.
Use this when you run into the situation in the title.
When not to use this skill: unrelated tasks. It covers only the procedure above.
Compatibility
The steps above apply to the commands named in them. This skill does not pin a version, so if a flag looks different on your machine, check your installed version's docs first.
Details
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 2 · 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>