From c94b73141b63990f1e2cd87406d69c9b9f302481 Mon Sep 17 00:00:00 2001
From: dorsha <dorsha@descope.com>
Date: Tue, 14 Jul 2026 13:12:30 +0300
Subject: [PATCH] feat: document external-group source on group listing
 responses

Group listing responses (load_all_groups / _for_members / _group_members, sync
and async) now carry a `source` field ("scim" | "jit") distinguishing
SCIM-provisioned groups from JIT (SSO SAML/OIDC assertion) groups. Responses are
dicts, so the field passes through automatically; document it in the response
shape. Mirrors the go-sdk change.
---
 descope/management/group.py       | 3 +++
 descope/management/group_async.py | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/descope/management/group.py b/descope/management/group.py
index d03ac1a8f..cbf6a07b1 100644
--- a/descope/management/group.py
+++ b/descope/management/group.py
@@ -21,6 +21,7 @@ def load_all_groups(
                 {
                     "id": <group id>,
                     "display": <display name>,
+                    "source": <"scim" or "jit">,
                     "members":[
                         {
                             "loginId": <loginId>,
@@ -63,6 +64,7 @@ def load_all_groups_for_members(
                 {
                     "id": <group id>,
                     "display": <display name>,
+                    "source": <"scim" or "jit">,
                     "members":[
                         {
                             "loginId": <loginId>,
@@ -108,6 +110,7 @@ def load_all_group_members(
                 {
                     "id": <group id>,
                     "display": <display name>,
+                    "source": <"scim" or "jit">,
                     "members":[
                         {
                             "loginId": <loginId>,
diff --git a/descope/management/group_async.py b/descope/management/group_async.py
index ee8492c58..25c4da2a9 100644
--- a/descope/management/group_async.py
+++ b/descope/management/group_async.py
@@ -25,6 +25,7 @@ async def load_all_groups(
                 {
                     "id": <group id>,
                     "display": <display name>,
+                    "source": <"scim" or "jit">,
                     "members":[
                         {
                             "loginId": <loginId>,
@@ -67,6 +68,7 @@ async def load_all_groups_for_members(
                 {
                     "id": <group id>,
                     "display": <display name>,
+                    "source": <"scim" or "jit">,
                     "members":[
                         {
                             "loginId": <loginId>,
@@ -112,6 +114,7 @@ async def load_all_group_members(
                 {
                     "id": <group id>,
                     "display": <display name>,
+                    "source": <"scim" or "jit">,
                     "members":[
                         {
                             "loginId": <loginId>,