AWS Security ChangesHomeSearch

AWS organizations: Explain ConstraintViolationException when removing project accounts

Service: organizations · 2026-10-15 · Documentation medium

File: organizations/latest/userguide/orgs_manage_accounts_remove.md · Type: iam

Summary

Added a section stating that project accounts created in AWS Settings are owned by an AWS Builder ID and cannot be removed from the organization; RemoveAccountFromOrganization fails with a ConstraintViolationException saying the account is owned by a Builder ID, and the workaround is to close the account.

Security assessment

Documents an ownership constraint and error behavior for account removal, which affects who controls membership/identity for these accounts, but it is operational guidance rather than a fix for a specific security flaw.

Evidence

+An AWS Builder ID owns the member accounts that you created as projects in AWS Settings. You can't remove these project accounts from the organization. If you try, `RemoveAccountFromOrganization` fails with a `ConstraintViolationException` error that says the account is owned by a Builder ID. To stop using a project account, close it. For more information about closing a member account, see [Closing a member account in an organization with AWS Organizations](./orgs_manage_accounts_close.html).

Diff

diff --git a/organizations/latest/userguide/orgs_manage_accounts_remove.md b/organizations/latest/userguide/orgs_manage_accounts_remove.md
index ef7e245..2b6c447 100644
--- a//organizations/latest/userguide/orgs_manage_accounts_remove.md
+++ b//organizations/latest/userguide/orgs_manage_accounts_remove.md
@@ -34,0 +35,4 @@ If you have AWS Enterprise Support and you are migrating accounts to another org
+**You can't remove a project account**
+
+An AWS Builder ID owns the member accounts that you created as projects in AWS Settings. You can't remove these project accounts from the organization. If you try, `RemoveAccountFromOrganization` fails with a `ConstraintViolationException` error that says the account is owned by a Builder ID. To stop using a project account, close it. For more information about closing a member account, see [Closing a member account in an organization with AWS Organizations](./orgs_manage_accounts_close.html).
+