[Docs][API][Asgrdeo] Introduce User Sharing API Documentation for Asgardeo

[BimsaraBodaragama]

Purpose

The API introduced in #22541 allows parent organization administrators to share users with sub-organizations. This PR adds the necessary API documentation for Asgardeo, ensuring that developers have clear guidance on how to use this feature.

Goals

• Add API documentation specifically for Asgardeo.
• Define API structure, including endpoints, parameters, and authentication.
• Provide request and response formats with sample payloads.
• Include usage examples for common scenarios.

Approach

• Created structured API documentation under Asgardeo API Docs.
• Documented the User Sharing API, covering:
  • Endpoints: Available API paths and methods.
  • Request/Response Formats: Payload structures for different operations.
  • Usage Examples: Sample API calls with expected responses.
• Ensured documentation adheres to WSO2 documentation standards.

---

Related Issue

[Docs][API][Asgardeo] Introduce User Sharing from Parent Org to Sub-Org #28754

---

References

Add API Support for Parent Organization Admins to Share Users with Sub-Organizations #22541