fix: API schema drift detected (2026-07-01)#35
Conversation
There was a problem hiding this comment.
Pull request overview
Updates the repository’s stored API schema snapshot to match the latest nightly-detected differences between the live API and the snapshot used for drift tracking/documentation.
Changes:
- Refreshed
generatedAttimestamp and updated multiple endpoint property type entries in the snapshot. - Reduced/altered schema detail in several places (e.g., array item shapes, nullable handling, and dynamic-key modeling).
- Removed multiple endpoints from the snapshot compared to the prior version.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| "generatedAt": "2026-07-01T07:47:46Z", | ||
| "endpoints": { |
| "lastAlignmentDateTime": "datetime" | ||
| } | ||
| }, | ||
| "alignmentSummaries": "array", |
| "tenantId": "integer", | ||
| "tenantFriendlyName": "string", | ||
| "score": "number", | ||
| "score": "integer", |
| "_properties": { | ||
| "user:username:244": "string", | ||
| "user:displayName:244": "string" | ||
| } |
| "description": "string", | ||
| "mail": "string", | ||
| "visibility": "string", |
| ] | ||
| }, | ||
| "generatedAt": "2026-07-01T07:47:46Z", | ||
| "endpoints": { |
Update (2026-07-02)Snapshot updated and pushed. Workflow run: https://github.com/royklo/Powershell-Module-Automation/actions/runs/28572601048 |
Update (2026-07-03)Snapshot updated and pushed. Workflow run: https://github.com/royklo/Powershell-Module-Automation/actions/runs/28644860899 |
| { | ||
| "generatedAt": "2026-06-29T08:01:48Z", | ||
| "_meta": { | ||
| "notes": [ | ||
| "Types use suffixes: '?' = nullable, '*' = pattern key. Bare types are observed-required-non-null in the sample.", | ||
| "Arrays use `_itemProperties` when the documented item shape is known; bare `\"array\"` only when items are truly schemaless (e.g. variant strings).", | ||
| "Nullable handling: API contract types are documented at docs/API-REFERENCE.md and considered the source of truth; sampled responses that happen to contain nulls do not collapse the documented type.", | ||
| "Reports / Assessment endpoints are part of the public surface in v0.5.0 and are included here." | ||
| ] | ||
| }, | ||
| "generatedAt": "2026-07-03T07:16:57Z", | ||
| "endpoints": { |
| "lastAlignmentDateTime": "datetime" | ||
| } | ||
| }, | ||
| "alignmentSummaries": "array", |
| "msTenantId": "string" | ||
| } | ||
| }, | ||
| "members": "array", |
| "isBaselineOnly": "boolean" | ||
| } | ||
| }, | ||
| "matchingVariables": "array", |
| "childCustomBaselineId": "null", | ||
| "policyCategoryProduct": "null", | ||
| "policyCategoryPrimaryGroup": "null", | ||
| "policyCategorySecondaryGroup": "null", | ||
| "alignAssignments": "boolean" |
| "clientIp": "string", | ||
| "clientIpv4": "string", | ||
| "clientIpv6": "string?", | ||
| "clientIpv6": "null", |
| "_properties": { | ||
| "user:username:244": "string", | ||
| "user:displayName:244": "string" | ||
| } |
| "mail": "string", | ||
| "mailNickname": "string", | ||
| "visibility": "string", | ||
| "membershipRule": "null", |
| "createdDateTime": "datetime", | ||
| "mailEnabled": "boolean", | ||
| "onPremisesSyncEnabled": "boolean?", | ||
| "onPremisesSyncEnabled": "null", |
| } | ||
| } |
Update (2026-07-04)Snapshot updated and pushed. Workflow run: https://github.com/royklo/Powershell-Module-Automation/actions/runs/28698668139 |
Update (2026-07-05)Snapshot updated and pushed. Workflow run: https://github.com/royklo/Powershell-Module-Automation/actions/runs/28733048033 |
| "generatedAt": "2026-07-05T07:15:59Z", | ||
| "endpoints": { |
| "lastAlignmentDateTime": "datetime" | ||
| } | ||
| }, | ||
| "alignmentSummaries": "array", |
| "msTenantId": "string" | ||
| } | ||
| }, | ||
| "members": "array", |
| "childCustomBaselineId": "null", | ||
| "policyCategoryProduct": "null", | ||
| "policyCategoryPrimaryGroup": "null", | ||
| "policyCategorySecondaryGroup": "null", |
| "tenantId": "integer", | ||
| "tenantFriendlyName": "string", | ||
| "score": "number", | ||
| "score": "integer", |
| "_type": "object", | ||
| "_patternProperties": { | ||
| "user:username:*": "string", | ||
| "user:displayName:*": "string" | ||
| "_properties": { | ||
| "user:username:244": "string", | ||
| "user:displayName:244": "string" | ||
| } |
| "description": "string", | ||
| "mail": "string", | ||
| "visibility": "string", |
| "description": "string", | ||
| "mail": "string", | ||
| "mailNickname": "string", | ||
| "visibility": "string", | ||
| "membershipRule": "null", |
| "createdDateTime": "datetime", | ||
| "mailEnabled": "boolean", | ||
| "onPremisesSyncEnabled": "boolean?", | ||
| "onPremisesSyncEnabled": "null", |
| "endpoints": { | ||
| "GET /beta/tenants": { |
Update (2026-07-06)Snapshot updated and pushed. Workflow run: https://github.com/royklo/Powershell-Module-Automation/actions/runs/28776025989 |
API Schema Drift Detected
The nightly schema check found differences between the live API and the stored snapshot.
What's included
docs/api-schema-snapshot.jsonwith current API schemasNext steps
production-readylabel is added