Skip to content

Conversation

@JagdishKhunti
Copy link

  • Added endpoint and schema descriptions for LicenseReportV1
  • Extracted common schema into a shared object for reuse in both LicenseReport and LicenseReportV1

- Added endpoint and schema descriptions for LicenseReportV1
- Extracted common schema into a shared object for reuse in both LicenseReport and LicenseReportV1
Copy link
Contributor

@pasha-zayko pasha-zayko left a comment

Choose a reason for hiding this comment

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

There are some changes commented on, but also the repeated pattern of the same type of missing items that should be corrected in the rest of the implementation.

Renamed LicenseReportV1 schemas to Report.* for consistency and updated all references. Added detailed descriptions, examples, and validation patterns to license, principal, and service plan fields. Improved API response codes and documentation for error handling and deletion endpoints.
Copy link
Contributor

@pasha-zayko pasha-zayko left a comment

Choose a reason for hiding this comment

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

There are several outstanding items to adjust

Updated the Data-Gateway JSON schema to clarify and expand user and device principal records, including required fields and more detailed property definitions. Enhanced the structure and examples for inferred attributes and enhanced identity data, added explicit nullability, and improved descriptions for service plan and license references. These changes improve schema accuracy and documentation for integrators.
@pasha-zayko pasha-zayko requested a review from Copilot December 2, 2025 16:20
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

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

Copilot wasn't able to review any files in this pull request.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Refactored user and device principal data schemas to use new CommonService, AssignedLicense, and PrincipalMetadata references under Report.PrincipalData. Simplified nullable property definitions and examples. Added 500 error responses to multiple API endpoints for improved error handling.
Revised the structure of the 'examples' field for assigned licenses, wrapping multiple example objects in an array and adding a new example. This improves consistency and clarity in the API specification.
Copy link
Contributor

@pasha-zayko pasha-zayko left a comment

Choose a reason for hiding this comment

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

Nearly there, just a couple of final adjustments needed

Refactored and expanded example objects for available licenses, users, and devices to improve clarity and coverage. Adjusted nesting and array structures for consistency and added additional sample entries to better illustrate expected data formats.
@JagdishKhunti JagdishKhunti merged commit 228bd67 into LAB-938-CSPM-main Dec 3, 2025
2 checks passed
@JagdishKhunti JagdishKhunti deleted the feature/LAB-980_Describe-V1-LicenseReport-API-Endpoints branch December 3, 2025 15:34
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.

2 participants