Skip to content

fix: API schema drift detected (2026-07-01)#35

Closed
royklo wants to merge 6 commits into
mainfrom
api-drift/2026-07-01
Closed

fix: API schema drift detected (2026-07-01)#35
royklo wants to merge 6 commits into
mainfrom
api-drift/2026-07-01

Conversation

@royklo

@royklo royklo commented Jul 1, 2026

Copy link
Copy Markdown
Owner

API Schema Drift Detected

The nightly schema check found differences between the live API and the stored snapshot.


What's included

  • Updated docs/api-schema-snapshot.json with current API schemas

Next steps

  1. Review the property changes above
  2. Push code fixes to this branch (aliases, tests, docs)
  3. Merge when the production-ready label is added

@royklo royklo added the api-drift API schema drift label Jul 1, 2026
Copilot AI review requested due to automatic review settings July 1, 2026 07:47
@royklo royklo added the api-drift API schema drift label Jul 1, 2026

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

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 generatedAt timestamp 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.

Comment thread docs/api-schema-snapshot.json Outdated
Comment on lines 2 to 3
"generatedAt": "2026-07-01T07:47:46Z",
"endpoints": {
"lastAlignmentDateTime": "datetime"
}
},
"alignmentSummaries": "array",
"tenantId": "integer",
"tenantFriendlyName": "string",
"score": "number",
"score": "integer",
Comment on lines +185 to 188
"_properties": {
"user:username:244": "string",
"user:displayName:244": "string"
}
Comment on lines +198 to +200
"description": "string",
"mail": "string",
"visibility": "string",
]
},
"generatedAt": "2026-07-01T07:47:46Z",
"endpoints": {
@royklo

royklo commented Jul 2, 2026

Copy link
Copy Markdown
Owner Author

Update (2026-07-02)


Snapshot updated and pushed.


Workflow run: https://github.com/royklo/Powershell-Module-Automation/actions/runs/28572601048

@royklo

royklo commented Jul 3, 2026

Copy link
Copy Markdown
Owner Author

Update (2026-07-03)


Snapshot updated and pushed.


Workflow run: https://github.com/royklo/Powershell-Module-Automation/actions/runs/28644860899

Copilot AI review requested due to automatic review settings July 3, 2026 07:16

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 13 comments.

Comment on lines 1 to 3
{
"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",
Comment on lines +44 to 48
"childCustomBaselineId": "null",
"policyCategoryProduct": "null",
"policyCategoryPrimaryGroup": "null",
"policyCategorySecondaryGroup": "null",
"alignAssignments": "boolean"
"clientIp": "string",
"clientIpv4": "string",
"clientIpv6": "string?",
"clientIpv6": "null",
Comment on lines +185 to 188
"_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",
Comment on lines 238 to 239
}
}
@royklo

royklo commented Jul 4, 2026

Copy link
Copy Markdown
Owner Author

Update (2026-07-04)


Snapshot updated and pushed.


Workflow run: https://github.com/royklo/Powershell-Module-Automation/actions/runs/28698668139

@royklo

royklo commented Jul 5, 2026

Copy link
Copy Markdown
Owner Author

Update (2026-07-05)


Snapshot updated and pushed.


Workflow run: https://github.com/royklo/Powershell-Module-Automation/actions/runs/28733048033

Copilot AI review requested due to automatic review settings July 5, 2026 07:16

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 19 comments.

Comment thread docs/api-schema-snapshot.json Outdated
Comment on lines 2 to 3
"generatedAt": "2026-07-05T07:15:59Z",
"endpoints": {
"lastAlignmentDateTime": "datetime"
}
},
"alignmentSummaries": "array",
"msTenantId": "string"
}
},
"members": "array",
Comment on lines +44 to +47
"childCustomBaselineId": "null",
"policyCategoryProduct": "null",
"policyCategoryPrimaryGroup": "null",
"policyCategorySecondaryGroup": "null",
"tenantId": "integer",
"tenantFriendlyName": "string",
"score": "number",
"score": "integer",
Comment on lines 184 to 188
"_type": "object",
"_patternProperties": {
"user:username:*": "string",
"user:displayName:*": "string"
"_properties": {
"user:username:244": "string",
"user:displayName:244": "string"
}
Comment on lines +198 to +200
"description": "string",
"mail": "string",
"visibility": "string",
Comment on lines +208 to +212
"description": "string",
"mail": "string",
"mailNickname": "string",
"visibility": "string",
"membershipRule": "null",
"createdDateTime": "datetime",
"mailEnabled": "boolean",
"onPremisesSyncEnabled": "boolean?",
"onPremisesSyncEnabled": "null",
Comment on lines 3 to 4
"endpoints": {
"GET /beta/tenants": {
@royklo

royklo commented Jul 6, 2026

Copy link
Copy Markdown
Owner Author

Update (2026-07-06)


Snapshot updated and pushed.


Workflow run: https://github.com/royklo/Powershell-Module-Automation/actions/runs/28776025989

@royklo royklo closed this Jul 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

api-drift API schema drift

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants