# Microsoft Entra ID (formerly Azure AD) Users.directory Object API

**Canonical:** https://apis.io/apis/azure-ad/azure-ad-users-directoryobject-api/  
**Provider:** Microsoft Entra ID (formerly Azure AD) — https://apis.io/providers/azure-ad/  
**Base URL:** https://login.microsoftonline.com  
**Documentation:** https://learn.microsoft.com/en-us/azure/active-directory-b2c/

Microsoft Entra ID (formerly Azure AD) Users.directory Object API is one of 186 APIs that [Microsoft Entra ID (formerly Azure AD)](https://apis.io/providers/azure-ad/) 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, API documentation, authentication docs, and a changelog.

The users.directoryObject API from Microsoft Entra ID (formerly Azure AD) — 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 (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-users-directoryobject-api-openapi.yml
- **Documentation** — https://learn.microsoft.com/en-us/graph/api/overview
- **Authentication** — https://learn.microsoft.com/en-us/graph/auth/
- **SDKs** — https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
- **ChangeLog** — https://developer.microsoft.com/en-us/graph/changelog
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/asyncapi/azure-ad-change-notifications-webhooks.yml
- **Documentation** — https://learn.microsoft.com/en-us/graph/change-notifications-overview

## Other Microsoft Entra ID (formerly Azure AD) APIs (12)

- [Azure AD B2C API](https://apis.io/apis/azure-ad/azure-ad-b2c-api/)
- [Microsoft Entra ID (formerly Azure AD) Admin.people Admin Settings API](https://apis.io/apis/azure-ad/azure-ad-admin-peopleadminsettings-api/)
- [Microsoft Entra ID (formerly Azure AD) Agreements.agreement API](https://apis.io/apis/azure-ad/azure-ad-agreements-agreement-api/)
- [Microsoft Entra ID (formerly Azure AD) Agreements.agreement Acceptance API](https://apis.io/apis/azure-ad/azure-ad-agreements-agreementacceptance-api/)
- [Microsoft Entra ID (formerly Azure AD) Agreements.agreement File API](https://apis.io/apis/azure-ad/azure-ad-agreements-agreementfile-api/)
- [Microsoft Entra ID (formerly Azure AD) Agreements.agreement File Localization API](https://apis.io/apis/azure-ad/azure-ad-agreements-agreementfilelocalization-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications API](https://apis.io/apis/azure-ad/azure-ad-applications-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications.application.Actions API](https://apis.io/apis/azure-ad/azure-ad-applications-application-actions-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications.application API](https://apis.io/apis/azure-ad/azure-ad-applications-application-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications.application.Functions API](https://apis.io/apis/azure-ad/azure-ad-applications-application-functions-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications.app Management Policy API](https://apis.io/apis/azure-ad/azure-ad-applications-appmanagementpolicy-api/)
- [Microsoft Entra ID (formerly Azure AD) Applications.directory Object API](https://apis.io/apis/azure-ad/azure-ad-applications-directoryobject-api/)

---

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