Feat: Added support for SCIM Groups API and Self-Service Organization Domain endpoints

[fern-api]

Changes

Added support for the following new and modified endpoints:

Groups API (SCIM Groups for Enterprise)

Change Type	Method	Endpoint	SDK Method
NEW	GET	/api/v2/groups	client.groups.list()
NEW	GET	/api/v2/groups/{id}	client.groups.get()
NEW	GET	/api/v2/groups/{id}/members	client.groups.members.list()
NEW	GET	/api/v2/users/{id}/groups	client.users.groups.list()
MODIFIED	POST	/api/v2/connections/{connectionId}/scim_configuration/tokens	Added scopes parameter with group permissions

Self-Service Organization Domain

Change Type	Method	Endpoint	SDK Method
NEW	GET	/api/v2/organizations/{id}/discovery-domains/name/{discovery_domain}	client.organizations.discoveryDomains.getByName()
MODIFIED	GET	/api/v2/organizations/{id}/discovery-domains/{discovery_domain_id}	Added use_for_organization_discovery response property
MODIFIED	GET	/api/v2/organizations/{id}/discovery-domains	Added use_for_organization_discovery response property
MODIFIED	PATCH	/api/v2/organizations/{id}/discovery-domains/{discovery_domain_id}	Added use_for_organization_discovery request/response property
MODIFIED	POST	/api/v2/organizations/{id}/discovery-domains	Added use_for_organization_discovery request/response property
MODIFIED	POST	/api/v2/self-service-profiles/{id}/sso-ticket	Added use_for_organization_discovery request property

---

New Properties

Groups API Response Properties

• id - Unique identifier for the group
• name - Name of the group
• external_id - External identifier for SCIM synchronization
• connection_id - Connection ID (when group_type == connection)
• organization_id - Organization ID (when group_type == organization)
• tenant_name - Tenant identifier
• created_at - Creation timestamp
• updated_at - Last update timestamp

Groups API Query Parameters

• connection_id (string) - Filter groups by connection ID
• name (string) - Exact match on group name
• external_id (string) - Exact match on external identifier
• fields (string) - Comma-separated list of fields to include
• from (string) - Pagination cursor
• take (integer) - Number of results per page

DoVe EA3 New Property

• use_for_organization_discovery (boolean) - Controls whether a verified domain participates in organization discovery flow (default: true)

---

Required Scopes

• read:groups - For Groups API endpoints

---

Manual Testing Snippet

import { ManagementClient } from "auth0";

// Create ManagementClient instance
const client = new ManagementClient({
  domain: "<DOMAIN>",
  clientId: "<CLIENT_ID>",
  clientSecret: "<CLIENT_SECRET>"
});

// ===== Groups API =====

// List all groups
const groups = await client.groups.list({ take: 10 });
console.log("groups:", groups.data);

// Get single group
const group = await client.groups.get("grp_xxx");
console.log("group:", group);

// Get group members
const members = await client.groups.members.list("grp_xxx", { take: 10 });
console.log("members:", members.data);

// Get user's groups
const userGroups = await client.users.groups.list("auth0|xxx", { take: 10 });
console.log("userGroups:", userGroups.data);

// List groups with filters
const filteredGroups = await client.groups.list({
  connection_id: "con_xxx",
  name: "my-group",
  external_id: "ext-123",
  take: 10
});
console.log("filteredGroups:", filteredGroups.data);

// ===== Organization Discovery Domains (DoVe EA3) =====

// Get discovery domain by name (NEW endpoint)
const domain = await client.organizations.discoveryDomains.getByName(
  "org_xxx",
  "example.com"
);
console.log("domain:", domain);
console.log("use_for_organization_discovery:", domain.use_for_organization_discovery);

// Create discovery domain with use_for_organization_discovery
const newDomain = await client.organizations.discoveryDomains.create(
  "org_xxx",
  {
    domain: "example.com",
    use_for_organization_discovery: true
  }
);
console.log("newDomain:", newDomain);

// Update discovery domain
const updatedDomain = await client.organizations.discoveryDomains.update(
  "org_xxx",
  "dd_xxx",
  {
    use_for_organization_discovery: false
  }
);
console.log("updatedDomain:", updatedDomain);

// List all discovery domains (includes use_for_organization_discovery)
const domains = await client.organizations.discoveryDomains.list("org_xxx");
console.log("domains:", domains.data);

// ===== Self-Service SSO Ticket =====

// Create SSO ticket with use_for_organization_discovery
const ticket = await client.selfServiceProfiles.ssoTicket.create(
  "ssp_xxx",
  {
    // ... other properties
    use_for_organization_discovery: true
  }
);
console.log("ticket:", ticket);

⚠️ Breaking Changes

1. EventStreams list() Return Type Change

The client.eventStreams.list() method now returns a Page object instead of a raw array.

Before:

public list(): core.HttpResponsePromise<Management.EventStreamResponseContent[]>

After:

public async list(): Promise<core.Page<Management.EventStreamResponseContent, Management.ListEventStreamsResponseContent>>

Migration:

// Before
const eventStreams = await client.eventStreams.list();
console.log(eventStreams); // Was an array

// After
const page = await client.eventStreams.list();
console.log(page.data); // Now access .data property
// Pagination support:
if (page.hasNextPage()) {
  const nextPage = await page.getNextPage();
}

2. Prompts Rendering list() Page Type Change

The page item type for client.prompts.rendering.list() changed from Management.AculResponseContent to Management.ListAculsResponseContentItem.

[codecov]

Codecov Report

❌ Patch coverage is 92.85714% with 20 lines in your changes missing coverage. Please review.
✅ Project coverage is 88.97%. Comparing base (1e93ed5) to head (ec39d55).

Files with missing lines	Patch %	Lines
...c/management/api/resources/groups/client/Client.ts	92.15%	8 Missing ⚠️
...gement/api/resources/eventStreams/client/Client.ts	90.69%	4 Missing ⚠️
...esources/groups/resources/members/client/Client.ts	93.33%	4 Missing ⚠️
.../resources/users/resources/groups/client/Client.ts	93.33%	4 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1289      +/-   ##
==========================================
+ Coverage   88.90%   88.97%   +0.06%     
==========================================
  Files         371      378       +7     
  Lines       16966    17215     +249     
  Branches     8413     8680     +267     
==========================================
+ Hits        15084    15317     +233     
- Misses       1882     1898      +16     

Flag	Coverage Δ
alltests	88.97% <92.85%> (+0.06%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
src/management/Client.ts	100.00% <100.00%> (ø)
src/management/api/requests/requests.ts	100.00% <ø> (ø)
src/management/api/resources/groups/index.ts	100.00% <100.00%> (ø)
...management/api/resources/groups/resources/index.ts	100.00% <100.00%> (ø)
...nt/api/resources/groups/resources/members/index.ts	100.00% <100.00%> (ø)
src/management/api/resources/index.ts	100.00% <100.00%> (ø)
...urces/prompts/resources/rendering/client/Client.ts	90.50% <100.00%> (ø)
...rc/management/api/resources/users/client/Client.ts	90.56% <100.00%> (+0.07%)	⬆️
...ment/api/resources/users/resources/groups/index.ts	100.00% <100.00%> (ø)
.../management/api/resources/users/resources/index.ts	100.00% <100.00%> (ø)
... and 6 more

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.