# Microsoft 365 Users.directory Object API

**Canonical:** https://apis.io/apis/microsoft-365/microsoft-365-users-directoryobject-api/  
**Provider:** Microsoft 365 — https://apis.io/providers/microsoft-365/  
**Base URL:** https://graph.microsoft.com/v1.0/  
**Documentation:** https://learn.microsoft.com/en-us/graph/overview

Microsoft 365 Users.directory Object API is one of 103 APIs that [Microsoft 365](https://apis.io/providers/microsoft-365/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. The published artifact set on APIs.io includes an OpenAPI specification.

The users.directoryObject API from Microsoft 365 — 84 operation(s) for users.directoryobject.

## Operations (60 of 88)

| Method | Path | Summary |
|---|---|---|
| GET | `/users/{user-id}/createdObjects` | Get createdObjects from users |
| GET | `/users/{user-id}/createdObjects/{directoryObject-id}` | Get createdObjects from users |
| GET | `/users/{user-id}/createdObjects/{directoryObject-id}/microsoft.graph.servicePrincipal` | Get the item of type microsoft.graph.directoryObject as… |
| GET | `/users/{user-id}/createdObjects/$count` | Get the number of the resource |
| GET | `/users/{user-id}/createdObjects/microsoft.graph.servicePrincipal` | Get the items of type microsoft.graph.servicePrincipal in the… |
| GET | `/users/{user-id}/createdObjects/microsoft.graph.servicePrincipal/$count` | Get the number of the resource |
| GET | `/users/{user-id}/directReports` | List directReports (for agentUser) |
| GET | `/users/{user-id}/directReports/{directoryObject-id}` | Get directReports from users |
| GET | `/users/{user-id}/directReports/{directoryObject-id}/microsoft.graph.orgContact` | Get the item of type microsoft.graph.directoryObject as… |
| GET | `/users/{user-id}/directReports/{directoryObject-id}/microsoft.graph.user` | Get the item of type microsoft.graph.directoryObject as microsoft.graph.user |
| GET | `/users/{user-id}/directReports/$count` | Get the number of the resource |
| GET | `/users/{user-id}/directReports/microsoft.graph.orgContact` | Get the items of type microsoft.graph.orgContact in the… |
| GET | `/users/{user-id}/directReports/microsoft.graph.orgContact/$count` | Get the number of the resource |
| GET | `/users/{user-id}/directReports/microsoft.graph.user` | Get the items of type microsoft.graph.user in the… |
| GET | `/users/{user-id}/directReports/microsoft.graph.user/$count` | Get the number of the resource |
| GET | `/users/{user-id}/manager` | List manager (for agentUser) |
| GET | `/users/{user-id}/manager/$ref` | List manager (for agentUser) |
| PUT | `/users/{user-id}/manager/$ref` | Assign manager |
| DELETE | `/users/{user-id}/manager/$ref` | Remove manager (for agentUser) |
| GET | `/users/{user-id}/memberOf` | List agentUser direct memberships |
| GET | `/users/{user-id}/memberOf/{directoryObject-id}` | Get memberOf from users |
| GET | `/users/{user-id}/memberOf/{directoryObject-id}/microsoft.graph.administrativeUnit` | Get the item of type microsoft.graph.directoryObject as… |
| GET | `/users/{user-id}/memberOf/{directoryObject-id}/microsoft.graph.directoryRole` | Get the item of type microsoft.graph.directoryObject as… |
| GET | `/users/{user-id}/memberOf/{directoryObject-id}/microsoft.graph.group` | List a user's direct memberships |
| GET | `/users/{user-id}/memberOf/$count` | Get the number of the resource |
| GET | `/users/{user-id}/memberOf/microsoft.graph.administrativeUnit` | Get the items of type microsoft.graph.administrativeUnit in the… |
| GET | `/users/{user-id}/memberOf/microsoft.graph.administrativeUnit/$count` | Get the number of the resource |
| GET | `/users/{user-id}/memberOf/microsoft.graph.directoryRole` | Get the items of type microsoft.graph.directoryRole in the… |
| GET | `/users/{user-id}/memberOf/microsoft.graph.directoryRole/$count` | Get the number of the resource |
| GET | `/users/{user-id}/memberOf/microsoft.graph.group` | List a user's direct memberships |
| GET | `/users/{user-id}/memberOf/microsoft.graph.group/$count` | Get the number of the resource |
| GET | `/users/{user-id}/ownedDevices` | Get ownedDevices from users |
| GET | `/users/{user-id}/ownedDevices/{directoryObject-id}` | Get ownedDevices from users |
| GET | `/users/{user-id}/ownedDevices/{directoryObject-id}/microsoft.graph.appRoleAssignment` | Get the item of type microsoft.graph.directoryObject as… |
| GET | `/users/{user-id}/ownedDevices/{directoryObject-id}/microsoft.graph.device` | Get the item of type microsoft.graph.directoryObject as microsoft.graph.device |
| GET | `/users/{user-id}/ownedDevices/{directoryObject-id}/microsoft.graph.endpoint` | Get the item of type microsoft.graph.directoryObject as microsoft.graph.endpoint |
| GET | `/users/{user-id}/ownedDevices/$count` | Get the number of the resource |
| GET | `/users/{user-id}/ownedDevices/microsoft.graph.appRoleAssignment` | Get the items of type microsoft.graph.appRoleAssignment in the… |
| GET | `/users/{user-id}/ownedDevices/microsoft.graph.appRoleAssignment/$count` | Get the number of the resource |
| GET | `/users/{user-id}/ownedDevices/microsoft.graph.device` | Get the items of type microsoft.graph.device in the… |
| GET | `/users/{user-id}/ownedDevices/microsoft.graph.device/$count` | Get the number of the resource |
| GET | `/users/{user-id}/ownedDevices/microsoft.graph.endpoint` | Get the items of type microsoft.graph.endpoint in the… |
| GET | `/users/{user-id}/ownedDevices/microsoft.graph.endpoint/$count` | Get the number of the resource |
| GET | `/users/{user-id}/ownedObjects` | List ownedObjects (for agentUser) |
| GET | `/users/{user-id}/ownedObjects/{directoryObject-id}` | Get ownedObjects from users |
| GET | `/users/{user-id}/ownedObjects/{directoryObject-id}/microsoft.graph.application` | Get the item of type microsoft.graph.directoryObject as… |
| GET | `/users/{user-id}/ownedObjects/{directoryObject-id}/microsoft.graph.group` | Get the item of type microsoft.graph.directoryObject as microsoft.graph.group |
| GET | `/users/{user-id}/ownedObjects/{directoryObject-id}/microsoft.graph.servicePrincipal` | Get the item of type microsoft.graph.directoryObject as… |
| GET | `/users/{user-id}/ownedObjects/$count` | Get the number of the resource |
| GET | `/users/{user-id}/ownedObjects/microsoft.graph.application` | Get the items of type microsoft.graph.application in the… |
| GET | `/users/{user-id}/ownedObjects/microsoft.graph.application/$count` | Get the number of the resource |
| GET | `/users/{user-id}/ownedObjects/microsoft.graph.group` | Get the items of type microsoft.graph.group in the… |
| GET | `/users/{user-id}/ownedObjects/microsoft.graph.group/$count` | Get the number of the resource |
| GET | `/users/{user-id}/ownedObjects/microsoft.graph.servicePrincipal` | Get the items of type microsoft.graph.servicePrincipal in the… |
| GET | `/users/{user-id}/ownedObjects/microsoft.graph.servicePrincipal/$count` | Get the number of the resource |
| GET | `/users/{user-id}/registeredDevices` | Get registeredDevices from users |
| GET | `/users/{user-id}/registeredDevices/{directoryObject-id}` | Get registeredDevices from users |
| GET | `/users/{user-id}/registeredDevices/{directoryObject-id}/microsoft.graph.appRoleAssignment` | Get the item of type microsoft.graph.directoryObject as… |
| GET | `/users/{user-id}/registeredDevices/{directoryObject-id}/microsoft.graph.device` | Get the item of type microsoft.graph.directoryObject as microsoft.graph.device |
| GET | `/users/{user-id}/registeredDevices/{directoryObject-id}/microsoft.graph.endpoint` | Get the item of type microsoft.graph.directoryObject as microsoft.graph.endpoint |

…and 28 more operations. They are listed in full on the page.

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/microsoft-365/openapi/microsoft-365-users-directoryobject-api-openapi.yml

## Other Microsoft 365 APIs (12)

- [Microsoft Graph API](https://apis.io/apis/microsoft-365/graph-api/)
- [Microsoft Graph Beta API](https://apis.io/apis/microsoft-365/graph-beta-api/)
- [Microsoft 365 Calendar API](https://apis.io/apis/microsoft-365/microsoft-365-calendar-api/)
- [Microsoft 365 Files API](https://apis.io/apis/microsoft-365/microsoft-365-files-api/)
- [Microsoft 365 Groups API](https://apis.io/apis/microsoft-365/microsoft-365-groups-api/)
- [Microsoft 365 Mail API](https://apis.io/apis/microsoft-365/microsoft-365-mail-api/)
- [Microsoft 365 Me API](https://apis.io/apis/microsoft-365/microsoft-365-me-api/)
- [Microsoft 365 Teams API](https://apis.io/apis/microsoft-365/microsoft-365-teams-api/)
- [Microsoft 365 Users API](https://apis.io/apis/microsoft-365/microsoft-365-users-api/)
- [Microsoft MCP Server for Enterprise](https://apis.io/apis/microsoft-365/mcp-server-enterprise/)
- [Microsoft 365 App Catalogs.teams App API](https://apis.io/apis/microsoft-365/microsoft-365-appcatalogs-teamsapp-api/)
- [Microsoft 365 Chats.chat.Actions API](https://apis.io/apis/microsoft-365/microsoft-365-chats-chat-actions-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/microsoft-365/microsoft-365-users-directoryobject-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/microsoft-365/.