Skip to content

devicetemplate-delete-owners.md

Latest commit

 

History

History
90 lines (64 loc) · 3.35 KB

devicetemplate-delete-owners.md

File metadata and controls

90 lines (64 loc) · 3.35 KB
title Remove deviceTemplate owner
description Remove an owner from a deviceTemplate object.
author sofia-geislinger
ms.localizationpriority medium
ms.subservice entra-id
doc_type apiPageType
ms.date 12/31/2024

Remove deviceTemplate owner

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Remove an owner from a deviceTemplate object. Owners can self-remove themselves. As an owner, no other administrator roles are necessary to create, update, delete the devices from this template, as well as to add or remove template owners.

All devices linked to the device template must be first deleted before deleting the template itself. Only registered owners of the template can perform this operation.

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

[!INCLUDE permissions-table]

[!INCLUDE rbac-devicestemplate-apis]

HTTP request

DELETE /directory/templates/deviceTemplates/{deviceTemplateId}/owners/{id}/$ref

Note: The {deviceTemplateId} in the request URL is the value of the id property of the device template and {id} represents the oid of the owner service principal.

Request headers

Name Description
Authorization Bearer {token}. Required. Learn more about authentication and authorization.

Request body

Don't supply a request body for this method.

Response

If successful, this method returns a 204 No Content response code. It doesn't return anything in the response body. Device templates can't be deleted until all linked devices are removed; otherwise, this method returns a 400 Bad Request response code. If the caller isn't the owner of the device template, this method returns a 403 Forbidden response code.

For more information, see Microsoft Graph error responses and resource types.

Examples

Request

The following example shows a request.

HTTP

DELETE https://graph.microsoft.com/beta/directory/templates/deviceTemplates/2d62b12a-0163-457d-9796-9602e9807e1/owners/00001111-aaaa-2222-bbbb-3333cccc4444/$ref

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Response

The following example shows the response.

HTTP/1.1 204 No Content