From eb2fa9d3d9c2cbc51ef241f696f3bcbd3d6f3480 Mon Sep 17 00:00:00 2001
From: Laura Beatris <48022589+LauraBeatris@users.noreply.github.com>
Date: Mon, 4 Nov 2024 10:37:10 -0300
Subject: [PATCH] Add section for invalid states

---
 docs/organizations/overview.mdx | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/organizations/overview.mdx b/docs/organizations/overview.mdx
index 0f4474fde2..7ac4ac332a 100644
--- a/docs/organizations/overview.mdx
+++ b/docs/organizations/overview.mdx
@@ -172,3 +172,11 @@ If the prebuilt components don't meet your specific needs or if you require more
 - [Creating an infinite paginated list of memberships](/docs/organizations/viewing-memberships)
 - [Inviting users to an organization](/docs/organizations/inviting-users), which also includes code for creating a custom list of invitations
 - [Managing memberships](/docs/organizations/managing-roles), which includes code for updating and deleting a user's membership, for inviting a user, and for creating a custom list of memberships, invitations, and requests
+
+## Invalid states
+
+Organizations can enter invalid states under certain conditions. Here are the common scenarios you should be aware of:
+
+### Missing member with elevated permissions
+
+An organization becomes invalid when it has no members with the following elevated permissions: `org:sys_memberships:read`, `org:sys_memberships:manage`, and `org:sys_profile:delete`. This typically occurs when removing the last admin or downgrading their role.