API documentation does not seem to conform to actual behavior - does it need update?

[inward-eye]

The response we are getting for this API is in this form:

{
"value": [
{
"identity": {
"displayName": "Firstname Lastname",
"url": "https://spsprodwus21.vssps.visualstudio.com/Abb9d19ad-2a17-4cfa-af94-2860838186fb/_apis/Identities/acdf698a-30b2-40d7-af49-3c937fe17b76",
"_links": {
"avatar": {
"href": "https://dev.azure.com/msdata/_apis/GraphProfile/MemberAvatars/aad.NmM1YjYxODctNTUwOS03MGY2LTg2MGYtMTNmYmZhMzBhMmU1"
}
},
"id": "acdf698a-30b2-40d7-af49-3c937fe17b76",
"uniqueName": "alias@microsoft.com",
"imageUrl": "https://dev.azure.com/msdata/_api/_common/identityImage?id=acdf698a-30b2-40d7-af49-3c937fe17b76",
"descriptor": "aad.NmM1YjYxODctNTUwOS03MGY2LTg2MGYtMTNmYmZhMzBhMmU1"
}
},

---

Document Details

⚠ Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

• ID: 009ae0e7-8558-742e-aa8c-592d31c9d553
• Version Independent ID: e4028daf-8bd1-1077-ab71-b5c8f16b780b
• Content: Teams - Get Team Members With Extended Properties - REST API (Azure DevOps Core)
• Content Source: docs-ref-autogen/7.1/core/Teams/Get-Team-Members-With-Extended-Properties.yml
• Service: azure-devops
• Sub-service: azure-devops-ref
• GitHub Login: @wnjenkin
• Microsoft Alias: whjenkin