Microsoft Graph devices.directoryObject API

openapi: 3.1.0
info:
  title: Microsoft Graph Admin Admin.admin devices.directoryObject API
  description: 'Microsoft Graph API for managing administrative resources in Microsoft Entra ID.

    This API enables administrators to manage Microsoft Edge browser settings, Internet Explorer mode configurations,

    site lists, shared browser sites, Microsoft 365 Apps installation options, people insights, service announcements,

    SharePoint settings, Copilot administration, directory administrative units, and admin consent policies.'
  version: 1.0.0
  contact:
    name: Microsoft Graph API Support
    url: https://developer.microsoft.com/graph
servers:
- url: https://graph.microsoft.com/v1.0
  description: Microsoft Graph API v1.0 endpoint
tags:
- name: devices.directoryObject
paths:
  /devices/{device-id}/memberOf:
    description: Provides operations to manage the memberOf property of the microsoft.graph.device entity.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    get:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph List device memberships
      description: Get groups and administrative units that this device is a direct member of. This operation is not transitive.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/device-list-memberof?view=graph-rest-1.0
      operationId: devices.ListMemberOf
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - $ref: '#/components/parameters/top'
      - $ref: '#/components/parameters/skip'
      - $ref: '#/components/parameters/search'
      - $ref: '#/components/parameters/filter'
      - $ref: '#/components/parameters/count'
      - name: $orderby
        in: query
        description: Order items by property values
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          $ref: '#/components/responses/microsoft.graph.directoryObjectCollectionResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
  /devices/{device-id}/memberOf/{directoryObject-id}:
    description: Provides operations to manage the memberOf property of the microsoft.graph.device entity.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    - name: directoryObject-id
      in: path
      description: The unique identifier of directoryObject
      required: true
      schema:
        type: string
      x-ms-docs-key-type: directoryObject
    get:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph Get memberOf from devices
      description: Groups and administrative units that this device is a member of. Read-only. Nullable. Supports $expand.
      operationId: devices.GetMemberOf
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.directoryObject'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /devices/{device-id}/memberOf/{directoryObject-id}/graph.administrativeUnit:
    description: Casts the previous resource to administrativeUnit.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    - name: directoryObject-id
      in: path
      description: The unique identifier of directoryObject
      required: true
      schema:
        type: string
      x-ms-docs-key-type: directoryObject
    get:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph Get the item of type microsoft.graph.directoryObject as microsoft.graph.administrativeUnit
      operationId: devices.GetMemberOf.AsAdministrativeUnit
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          description: Entity result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.administrativeUnit'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
  /devices/{device-id}/memberOf/{directoryObject-id}/graph.group:
    description: Casts the previous resource to group.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    - name: directoryObject-id
      in: path
      description: The unique identifier of directoryObject
      required: true
      schema:
        type: string
      x-ms-docs-key-type: directoryObject
    get:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph List device memberships
      description: Get groups and administrative units that this device is a direct member of. This operation is not transitive.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/device-list-memberof?view=graph-rest-1.0
      operationId: devices.GetMemberOf.AsGroup
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          description: Entity result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.group'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
  /devices/{device-id}/memberOf/$count:
    description: Provides operations to count the resources in the collection.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    get:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph Get the number of the resource
      operationId: devices.memberOf.GetCount-bd14
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - $ref: '#/components/parameters/search'
      - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
  /devices/{device-id}/memberOf/graph.administrativeUnit:
    description: Casts the previous resource to administrativeUnit.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    get:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph Get the items of type microsoft.graph.administrativeUnit in the microsoft.graph.directoryObject collection
      operationId: devices.ListMemberOf.AsAdministrativeUnit
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - $ref: '#/components/parameters/top'
      - $ref: '#/components/parameters/skip'
      - $ref: '#/components/parameters/search'
      - $ref: '#/components/parameters/filter'
      - $ref: '#/components/parameters/count'
      - name: $orderby
        in: query
        description: Order items by property values
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          $ref: '#/components/responses/microsoft.graph.administrativeUnitCollectionResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
  /devices/{device-id}/memberOf/graph.administrativeUnit/$count:
    description: Provides operations to count the resources in the collection.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    get:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph Get the number of the resource
      operationId: devices.MemberOf.GetCount.AsAdministrativeUnit-dd3f
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - $ref: '#/components/parameters/search'
      - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
  /devices/{device-id}/memberOf/graph.group:
    description: Casts the previous resource to group.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    get:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph List device memberships
      description: Get groups and administrative units that this device is a direct member of. This operation is not transitive.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/device-list-memberof?view=graph-rest-1.0
      operationId: devices.ListMemberOf.AsGroup
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - $ref: '#/components/parameters/top'
      - $ref: '#/components/parameters/skip'
      - $ref: '#/components/parameters/search'
      - $ref: '#/components/parameters/filter'
      - $ref: '#/components/parameters/count'
      - name: $orderby
        in: query
        description: Order items by property values
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          $ref: '#/components/responses/microsoft.graph.groupCollectionResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
  /devices/{device-id}/memberOf/graph.group/$count:
    description: Provides operations to count the resources in the collection.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    get:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph Get the number of the resource
      operationId: devices.MemberOf.GetCount.AsGroup-3872
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - $ref: '#/components/parameters/search'
      - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
  /devices/{device-id}/registeredOwners:
    description: Provides operations to manage the registeredOwners property of the microsoft.graph.device entity.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    get:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph List registeredOwners
      description: Retrieve a list of users that are registered owners of the device. A registered owner is the user that cloud joined the device or registered their personal device. The registered owner is set at the time of registration. Currently, there can be only one owner.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/device-list-registeredowners?view=graph-rest-1.0
      operationId: devices.ListRegisteredOwners
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - $ref: '#/components/parameters/top'
      - $ref: '#/components/parameters/skip'
      - $ref: '#/components/parameters/search'
      - $ref: '#/components/parameters/filter'
      - $ref: '#/components/parameters/count'
      - name: $orderby
        in: query
        description: Order items by property values
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          $ref: '#/components/responses/microsoft.graph.directoryObjectCollectionResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
  /devices/{device-id}/registeredOwners/{directoryObject-id}/$ref:
    description: Provides operations to manage the collection of device entities.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    - name: directoryObject-id
      in: path
      description: The unique identifier of directoryObject
      required: true
      schema:
        type: string
      x-ms-docs-key-type: directoryObject
    delete:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph Delete registeredOwner
      description: Remove a user as a registered owner of the device.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/device-delete-registeredowners?view=graph-rest-1.0
      operationId: devices.registeredOwners.DeleteRefDirectoryObject
      parameters:
      - name: If-Match
        in: header
        description: ETag
        schema:
          type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /devices/{device-id}/registeredOwners/{directoryObject-id}/graph.appRoleAssignment:
    description: Casts the previous resource to appRoleAssignment.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    - name: directoryObject-id
      in: path
      description: The unique identifier of directoryObject
      required: true
      schema:
        type: string
      x-ms-docs-key-type: directoryObject
    get:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph Get the item of type microsoft.graph.directoryObject as microsoft.graph.appRoleAssignment
      operationId: devices.GetRegisteredOwners.AsAppRoleAssignment
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          description: Entity result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.appRoleAssignment'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
  /devices/{device-id}/registeredOwners/{directoryObject-id}/graph.endpoint:
    description: Casts the previous resource to endpoint.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    - name: directoryObject-id
      in: path
      description: The unique identifier of directoryObject
      required: true
      schema:
        type: string
      x-ms-docs-key-type: directoryObject
    get:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph Get the item of type microsoft.graph.directoryObject as microsoft.graph.endpoint
      operationId: devices.GetRegisteredOwners.AsEndpoint
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          description: Entity result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.endpoint'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
  /devices/{device-id}/registeredOwners/{directoryObject-id}/graph.servicePrincipal:
    description: Casts the previous resource to servicePrincipal.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    - name: directoryObject-id
      in: path
      description: The unique identifier of directoryObject
      required: true
      schema:
        type: string
      x-ms-docs-key-type: directoryObject
    get:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph Get the item of type microsoft.graph.directoryObject as microsoft.graph.servicePrincipal
      operationId: devices.GetRegisteredOwners.AsServicePrincipal
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          description: Entity result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.servicePrincipal'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
  /devices/{device-id}/registeredOwners/{directoryObject-id}/graph.user:
    description: Casts the previous resource to user.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    - name: directoryObject-id
      in: path
      description: The unique identifier of directoryObject
      required: true
      schema:
        type: string
      x-ms-docs-key-type: directoryObject
    get:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph Get the item of type microsoft.graph.directoryObject as microsoft.graph.user
      operationId: devices.GetRegisteredOwners.AsUser
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          description: Entity result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.user'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
  /devices/{device-id}/registeredOwners/$count:
    description: Provides operations to count the resources in the collection.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    get:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph Get the number of the resource
      operationId: devices.registeredOwners.GetCount-d4e7
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - $ref: '#/components/parameters/search'
      - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
  /devices/{device-id}/registeredOwners/$ref:
    description: Provides operations to manage the collection of device entities.
    parameters:
    - name: device-id
      in: path
      description: The unique identifier of device
      required: true
      schema:
        type: string
      x-ms-docs-key-type: device
    get:
      tags:
      - devices.directoryObject
      summary: Microsoft Graph List registeredOwners
      description: Retrieve a list of users that are registered owners of the device. A registered owner is the user that cloud joined the device or registered their personal device. The registered owner is set at the time of registration. Currently, there can be only one owner.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/device-list-registeredowners?view=graph-rest-1.0
      operationId: devices.ListRefRegisteredOwners
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $coun

# --- truncated at 32 KB (1194 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-graph/refs/heads/main/openapi/microsoft-graph-devices-directoryobject-api-openapi.yml