---
title: "Batch update device assets"
method: PATCH
path: "/assets/devices/batch"
tags: ["Assets"]
---

# Batch update device assets

`PATCH /assets/devices/batch`

## Request

- Base URL: `https://console.jumpcloud.com/api/v2`
- URL: `https://console.jumpcloud.com/api/v2/assets/devices/batch`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/docs/assets/devices/batch/patch.ts> (a function with typed inputs; its response is checked against the schema)

Update multiple device assets with a single field value change

## Request body

- JumpcloudHttpAssetsBatchUpdateDeviceAssetsRequest: Request payload for batch updating multiple device assets with a single field value
  - `assetIds` string[], required: Array of device asset IDs to update
  - `fieldValue` JumpcloudHttpAssetsBatchUpdateFieldValue: Field value for batch updating assets
    - `label` string, required: The label of the field to update
    - `value` JumpcloudHttpAssetsBatchUpdateReference, required: Reference value for batch update operations
      - `id` string, required: The reference ID
      - `name` string: The reference display name
      - `type` 'user' | 'user_group' | 'location' | 'select' | 'device_group': The type of reference
  - `fields` object: Asset field values organized by field label to update

## Response `200`

Batch update completed

- JumpcloudHttpAssetsBatchUpdateDeviceAssetsResponse: Response containing results of batch device asset update operation
  - `updatedAssetCount` integer, required: Number of assets successfully updated
  - `notUpdatedAssetCount` integer, required: Number of assets that could not be updated

## Other responses

- `400`: Bad request - invalid data
- `401`: Unauthorized - authentication required
- `default`: Generic error response

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/revisions/3f09fe63caaa?raw)