Admin handover job statuses reference

This page lists every status the AdminHandover.status field can hold and what each means for the predecessor and successor accounts.

Job statuses

Status	Meaning	Predecessor account status
pending_successor_invite	Handover accepted; the invited successor has not yet accepted their admin invitation. The transfer has not started.	active — unchanged.
in_progress	Transfer job is running; roles and record-ownership writes are in flight.	active — unchanged until job completes.
complete	All transfers written; predecessor account archived; confirmation emails sent to both parties. Terminal state.	handover_complete — archived; cannot log in.
failed	Transfer job encountered an error (for example, a database error mid-transfer). No partial writes are committed.	active — unchanged; predecessor retains full access.

Behavior notes

Topic	Detail
Async job	The handover API returns HTTP 202. The client polls admin_handovers_get using the Location header from the 202 response.
In-app status	A banner in the admin console shows the current job status while the handover is in progress.
On failure	The predecessor account remains active. Retry the job from the handover list. If retry does not resolve the issue, contact MapleGather support.
Terminal state	complete is terminal. The predecessor record cannot be reactivated after a successful handover.

Related

• Run the account handover workflow
• Admin account and invitation statuses reference