Skip to content

feat: document external-group source on group listing responses#1620

Open
dorsha wants to merge 1 commit into
mainfrom
feat/external-group-source
Open

feat: document external-group source on group listing responses#1620
dorsha wants to merge 1 commit into
mainfrom
feat/external-group-source

Conversation

@dorsha

@dorsha dorsha commented Jul 14, 2026

Copy link
Copy Markdown
Member

What

Group listing responses (load_all_groups / load_all_groups_for_members / load_all_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 — this documents it in the response shape.

Why

Backend now persists JIT (SSO assertion) groups as external groups so the {{user.idpGroups}} claim survives token refresh, and the management group API exposes their origin via a new source field. This mirrors the equivalent go-sdk / node-sdk changes so all SDKs surface it.

Related

🤖 Generated with Claude Code

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.
@shuni-bot

shuni-bot Bot commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

🐕 Review complete — View session on Shuni Portal 🐾

@shuni-bot

shuni-bot Bot commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

🐕 Suggested Reviewers

The review assignment focuses on covering both synchronous and asynchronous group management modules, with contributors selected based on their specific file contributions to ensure thorough review of the new 'source' field implementation in group responses.

Reviewer Reason
itaihanski itaihanski should review the changes in descope/management/group.py, as they made multiple commits across this file and can assess the modifications related to group management.
tebeka tebeka has also contributed to descope/management/group.py and should review to ensure consistency and correctness in the group listing response updates.
LioriE LioriE contributed to descope/management/group_async.py, which involves asynchronous code related to group management, making their review important for concurrency correctness and completeness.

Suggested by Shuni based on git history and PR context. Names are not @-mentioned to avoid notifying anyone — request a review from whoever fits best.

@dorsha dorsha enabled auto-merge (squash) July 14, 2026 10:14

@shuni-bot shuni-bot Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🐕 Shuni's Review

Documents a new source field ("scim" | "jit") in the group-listing response docstrings for both sync and async clients.

No issues found — good bones! Pure docstring change, consistent across all three methods and both files. Woof!

@github-actions

Copy link
Copy Markdown

Coverage report

The coverage rate went from 98.24% to 98.24% ➡️

None of the new lines are part of the tested code. Therefore, there is no coverage data about them.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant