feat: support Organization Domain Discovery

[ewanharris]

🔧 Changes

Warning

This feature is currently behind a feature flag so will not work until the release is finalised

Adds support for the Organization Domain Discovery endpoints and the new property on a client that can be used to control the behaviour for discovery.

package main

import (
	"context"
	"log"

	"github.com/auth0/go-auth0"
	"github.com/auth0/go-auth0/management"
)

func main() {
	mgmt, err := management.New(
		"",
		management.WithClientCredentials(context.Background(), "", ""),
	)
	if err != nil {
		log.Fatalf("err setting up client %+v", err)
	}

	org_id := "ADD_ME"

	// cleanup
	list, err := mgmt.Organization.DiscoveryDomains(context.TODO(), org_id)
	if err != nil {
		log.Fatalf("err getting discovery domains: %+v", err)
	}
	log.Printf("found %d discovery domains", len(list.Domains))

	for _, d := range list.Domains {
		err = mgmt.Organization.DeleteDiscoveryDomain(context.TODO(), org_id, d.GetID())
		if err != nil {
			log.Fatalf("err deleting discovery domain: %+v", err)
		}
		log.Printf("deleted discovery domain: %+v", d)
	}

	domain := &management.OrganizationDiscoveryDomain{
		Domain: auth0.String("example.com"),
		Status: auth0.String("pending"),
	}

	// Create
	err = mgmt.Organization.CreateDiscoveryDomain(context.TODO(), org_id, domain)
	if err != nil {
		log.Fatalf("err creating discovery domain: %+v", err)
	}
	log.Printf("created discovery domain: %+v", domain)

	// List
	list, err = mgmt.Organization.DiscoveryDomains(context.TODO(), org_id)
	if err != nil {
		log.Fatalf("err getting discovery domains: %+v", err)
	}

	for _, d := range list.Domains {
		log.Printf("domain: %+v", d)
	}

	// update
	domain.Status = auth0.String("verified")
	err = mgmt.Organization.UpdateDiscoveryDomain(context.TODO(), org_id, domain.GetID(), domain)
	if err != nil {
		log.Fatalf("err updating discovery domain: %+v", err)
	}
	log.Printf("updated discovery domain: %+v", domain)

	// delete
	err = mgmt.Organization.DeleteDiscoveryDomain(context.TODO(), org_id, domain.GetID())
	if err != nil {
		log.Fatalf("err deleting discovery domain: %+v", err)
	}
	log.Printf("deleted discovery domain: %+v", domain)

}

📚 References

🔬 Testing

Manually tested using above script and automated tests added

📝 Checklist

• All new/changed/fixed functionality is covered by tests (or N/A)
• I have added documentation for all new/changed functionality (or N/A)

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 96.29%. Comparing base (5749258) to head (9f994d0).

Additional details and impacted files

@@            Coverage Diff             @@
##               v1     #612      +/-   ##
==========================================
+ Coverage   96.27%   96.29%   +0.01%     
==========================================
  Files          62       62              
  Lines       12918    12975      +57     
==========================================
+ Hits        12437    12494      +57     
  Misses        363      363              
  Partials      118      118              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[developerkunal]

LGTM

[developerkunal]

@claude

[github-actions]

Claude finished @developerkunal's task —— View job

---

Review Progress

• Read project context (AGENTS.md)
• Analyze PR diff
• Code quality review
• Security review
• Performance review
• Provide overall assessment

---

Overall Assessment

⚠️ This PR introduces the Organization Domain Discovery feature with comprehensive test coverage and follows the codebase patterns well. However, there are minor code quality issues that should be addressed: unsafe type assertion in error handling, potential pointer reassignment side effects in the update method, and opportunities to improve test robustness with better random value generation. The documentation also has minor inconsistencies between field names and comments.

---

Job Run | Branch: feat/organization-domain-discovery