Skip to content

teamworkdevice-updatesoftware.md

Latest commit

 

History

History
128 lines (94 loc) · 4.79 KB

teamworkdevice-updatesoftware.md

File metadata and controls

128 lines (94 loc) · 4.79 KB
title teamworkDevice: updateSoftware
description Update the software for a Microsoft Teams-enabled device.
author adsrivastava2
ms.localizationpriority medium
ms.subservice teams
doc_type apiPageType
ms.date 04/04/2024

teamworkDevice: updateSoftware

Namespace: microsoft.graph

[!INCLUDE beta-deprecation-disclaimer]

[!INCLUDE beta-disclaimer]

Update the software for a Microsoft Teams-enabled device. This API triggers a long-running operation.

[!INCLUDE teamworkdevice-api-disclaimer]

[!INCLUDE national-cloud-support]

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]

HTTP request

POST /teamwork/devices/{teamworkDeviceId}/updateSoftware

Request headers

Name Description
Authorization Bearer {token}. Required. Learn more about authentication and authorization.
Content-Type application/json. Required.

Request body

In the request body, supply a JSON representation of the parameters.

The following table shows the parameters that can be used with this action.

Parameter Type Description
softwareType teamworkSoftwareType The software type to update. Valid types are: adminAgent, operatingSystem, teamsClient, firmware, partnerAgent, companyPortal.
softwareVersion String Specifies the version of the software available for update.

Response

If successful, this method returns a 202 Accepted response code. The response will also contain a Location header, which contains the location of the teamworkDeviceOperation resource. You can check the status of the software update operation by making a GET request to this location that returns whether the operation is queued, succeeded, or failed.

This method also returns a 409 Conflict response code if the operation is already in queued state.

Examples

Request

HTTP

POST https://graph.microsoft.com/beta/teamwork/devices/0f3ce432-e432-0f3c-32e4-3c0f32e43c0f/updateSoftware
Content-Type: application/json
Content-length: 64

{
  "softwareType": "teamsClient",
  "softwareVersion": "1.0.96.22"
}

C#

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

Go

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

Java

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

JavaScript

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

PHP

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

PowerShell

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

Python

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

Response

HTTP/1.1 202 Accepted
Location: /teamwork/devices/0f3ce432-e432-0f3c-32e4-3c0f32e43c0f/operations/119eb06d-0c4b-4fb3-a754-33dd0d6b618c
Content-Type: text/plain
Content-Length: 0