Promote agentUser APIs from beta to v1.0#9881
Closed
tafra00 wants to merge 1 commit into
Closed
Conversation
- Add agentUser resource and 18 API methods to v1.0 - Add RBAC include for agentUser write operations - Update directory-deleteditems APIs (list, get, restore, delete) to support agentUser - Remove beta disclaimers, update endpoints to /v1.0/, remove SDK snippets - Update TOC mappings for both beta and v1.0 - Add changelog entries for DirectoryServices workload - Update What's New overview for April 2026 Addresses GA promotion of agentUser resource with support for deleted items operations.
Contributor
|
Learn Build status updates of commit 55f7cfe:
|
Contributor
There was a problem hiding this comment.
Pull request overview
Promotes the agentUser resource and related APIs from beta to v1.0, updates directory deletedItems documentation to include agentUser, and surfaces the change through TOC, changelog, and April 2026 “What’s new”.
Changes:
- Added new v1.0 resource + API reference topics for agentUser (CRUD + relationships + app role assignments).
- Updated directory deletedItems (list/get/restore/permanently delete) docs to include agentUser.
- Updated discoverability and release comms: TOC mappings (beta + v1.0), DirectoryServices changelog entry, and April 2026 What’s New.
Reviewed changes
Copilot reviewed 28 out of 28 changed files in this pull request and generated 23 comments.
Show a summary per file
| File | Description |
|---|---|
| concepts/whats-new-overview.md | Adds April 2026 GA entry for agentUser in v1.0. |
| changelog/Microsoft.DirectoryServices.json | Adds DirectoryServices changelog record announcing agentUser GA + methods. |
| api-reference/v1.0/toc/toc.mapping.json | Adds v1.0 TOC node for Agent user resource. |
| api-reference/v1.0/resources/agentuser.md | Introduces v1.0 agentUser resource reference topic. |
| api-reference/v1.0/includes/rbac-for-apis/rbac-agent-user-apis-write.md | Adds RBAC include for agentUser write operations. |
| api-reference/v1.0/api/directory-deleteditems-list.md | Updates list deletedItems to include agentUser (and other types). |
| api-reference/v1.0/api/directory-deleteditems-get.md | Updates get deletedItem to include agentUser (and other types). |
| api-reference/v1.0/api/directory-deleteditems-restore.md | Updates restore deletedItem to include agentUser (and other types). |
| api-reference/v1.0/api/directory-deleteditems-delete.md | Updates permanently delete deletedItem to include agentUser (and other types). |
| api-reference/v1.0/api/agentuser-list.md | Adds List agentUser API topic. |
| api-reference/v1.0/api/agentuser-post.md | Adds Create agentUser API topic. |
| api-reference/v1.0/api/agentuser-get.md | Adds Get agentUser API topic. |
| api-reference/v1.0/api/agentuser-update.md | Adds Update agentUser API topic. |
| api-reference/v1.0/api/agentuser-delete.md | Adds Delete agentUser API topic. |
| api-reference/v1.0/api/agentuser-list-approleassignments.md | Adds List appRoleAssignments for agentUser. |
| api-reference/v1.0/api/agentuser-post-approleassignments.md | Adds Create appRoleAssignment for agentUser. |
| api-reference/v1.0/api/agentuser-list-directreports.md | Adds List directReports for agentUser. |
| api-reference/v1.0/api/agentuser-list-manager.md | Adds List manager for agentUser. |
| api-reference/v1.0/api/agentuser-post-manager.md | Adds Add manager for agentUser. |
| api-reference/v1.0/api/agentuser-delete-manager.md | Adds Remove manager for agentUser. |
| api-reference/v1.0/api/agentuser-list-memberof.md | Adds List memberOf for agentUser. |
| api-reference/v1.0/api/agentuser-list-transitivememberof.md | Adds List transitiveMemberOf for agentUser. |
| api-reference/v1.0/api/agentuser-list-transitivereports.md | Adds List transitiveReports for agentUser. |
| api-reference/v1.0/api/agentuser-list-ownedobjects.md | Adds List ownedObjects for agentUser. |
| api-reference/v1.0/api/agentuser-list-sponsors.md | Adds List sponsors for agentUser. |
| api-reference/v1.0/api/agentuser-post-sponsors.md | Adds Add sponsors for agentUser. |
| api-reference/v1.0/api/agentuser-delete-sponsors.md | Adds Remove sponsor for agentUser. |
| api-reference/beta/toc/toc.mapping.json | Renames beta TOC node from “Agent user (preview)” to “Agent user”. |
Comments suppressed due to low confidence (1)
api-reference/v1.0/api/directory-deleteditems-list.md:176
- This example still includes SDK snippet includes and tabbed-language sections (starting with the Go snippet include). Per repo guidance, examples should be HTTP-only and SDK snippets/tabs should be removed (especially since other examples in this file were already converted to HTTP-only).
[!INCLUDE [sample-code](../includes/snippets/go/list-directory-deleteditems-count-go-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
# [Java](#tab/java)
Comment on lines
+94
to
+99
| { | ||
| "value": { | ||
| "@odata.type": "#microsoft.graph.agentUser", | ||
| "id": "929393ae-1e1d-159f-0d83-29f7df42e7b9", | ||
| "deletedDateTime": "String (timestamp)", | ||
| "signInActivity": { |
Comment on lines
+78
to
+92
| >**Note:** The response object shown here might be shortened for readability. | ||
| <!-- { | ||
| "blockType": "response", | ||
| "truncated": true, | ||
| "@odata.type": "microsoft.graph.directoryObject" | ||
| } | ||
| --> | ||
| ``` http | ||
| HTTP/1.1 204 No Content | ||
| Content-Type: application/json | ||
|
|
||
| { | ||
| "@odata.type": "#microsoft.graph.directoryObject", | ||
| "id": "a6c034b8-621b-dee3-6abb-52cbce801fe9" | ||
| } |
Comment on lines
+37
to
+40
| ``` http | ||
| GET /users/{usersId}/transitiveReports/$count | ||
| ``` | ||
|
|
| "value": [ | ||
| { | ||
| "@odata.type": "#microsoft.graph.directoryObject", | ||
| "id": "a6c034b8-621b-dee3-6abb-52cbce801fe9", |
| "value": [ | ||
| { | ||
| "@odata.type": "#microsoft.graph.directoryObject", | ||
| "id": "a6c034b8-621b-dee3-6abb-52cbce801fe9", |
Comment on lines
+37
to
+39
| ``` http | ||
| DELETE /users/{usersId}/manager/{id}/$ref | ||
| ``` |
| "value": [ | ||
| { | ||
| "@odata.type": "#microsoft.graph.directoryObject", | ||
| "id": "a6c034b8-621b-dee3-6abb-52cbce801fe9", |
Comment on lines
+70
to
+79
| { | ||
| "@odata.type": "#microsoft.graph.appRoleAssignment", | ||
| "deletedDateTime": "String (timestamp)", | ||
| "appRoleId": "Guid", | ||
| "creationTimestamp": "String (timestamp)", | ||
| "principalDisplayName": "String", | ||
| "principalId": "Guid", | ||
| "principalType": "String", | ||
| "resourceDisplayName": "String", | ||
| "resourceId": "Guid" |
Comment on lines
+24
to
+26
| - [externalUserProfile](../resources/externaluserprofile.md) | ||
| - [group](../resources/group.md) | ||
| - [pendingExternalUserProfile](../resources/pendingexternaluserprofile.md) |
Comment on lines
+89
to
+93
| { | ||
| "value": | ||
| { | ||
| "@odata.type": "#microsoft.graph.agentUser", | ||
| "id": "84e0b4dc-e852-29ed-1e5d-9e1f335611e8", |
FaithOmbongi
requested changes
Apr 28, 2026
Contributor
FaithOmbongi
left a comment
FaithOmbongi
left a comment
There was a problem hiding this comment.
Hi @tafra00 - We don't accept schema-related contributions in the public repo because we can't validate the integrity of the changes due to validations that intentionally don't run in public repos for privacy reasons.
Please move these changes to the private repo and set the review labels so the PR can be attended to ASAP.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Addresses GA promotion of agentUser resource with support for deleted items operations.
Important
Required for API changes:
Add other supporting information, such as a description of the PR changes:
ADD INFORMATION HERE
Important
The following guidance is for Microsoft employees only. Community contributors can ignore this message; our content team will manage the status.
After you've created your PR, expand this section for tips and additional instructions.
#feedback-addressedto the pull request.For more information, see the Content review process summary.