---
title: "Update an asset"
method: PATCH
path: "/industrial/assets/{id}"
tags: ["Industrial"]
---

# Update an asset

`PATCH /industrial/assets/{id}`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/industrial/assets/{id}`
- Auth: HTTP bearer

Update an existing asset. Only the provided fields will be updated. 

 **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.

To use this endpoint, select **Write Equipment** under the Equipment category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>

## Path parameters

- `id` string, required

## Request body

- AssetPatch: The asset creation arguments
  - `customMetadata` CustomMetadata: The custom fields of an asset.
  - `location` AssetLocation: For locationType "point", latitude and longitude are required. For "address", formattedAddress must be provided, and lat/long can be optionally included for displaying a dot on the assets map. For "dataInput", this object should not be passed in.
    - `formattedAddress` string: Formatted address of the location
    - `latitude` number, double: The latitude of the asset in decimal degrees.
    - `longitude` number, double: The longitude of the asset in decimal degrees.
  - `locationDataInputId` string: Required if locationType is "dataInput". Specifies the id of a location data input which will determine the asset's location. The data input must be in the asset.
  - `locationType` 'point' | 'address' | 'dataInput': The format of the location. This field is required if a location is provided. Valid values: `point`, `address`, `dataInput`.
  - `name` string: The name of the asset.
  - `parentId` string: The id of the parent asset that the asset belongs to. Pass in an empty string to remove the child from the parent.
  - `runningStatusDataInputId` string: The asset's isRunning status will be true when the associated data input's value is 1. Data input cannot be of location format. The data input must be in the asset.
  - `tagIds` string[]: The ids of the tags that the asset should belong to.

## Response `200`

The updated asset

- InlineResponse200
  - `data` AssetResponse: Asset
    - `customMetadata` CustomMetadata: The custom fields of an asset.
    - `dataOutputs` AssetDataOutput[]: The list of data outputs configured on the asset.
      - `dataGroup` string: Name of the data group that the data output is associated with
      - `dataInput` AssetDataInput
        - `dataGroup` string: Name of the data group that the data input is associated with
        - `id` string: ID of the data input
        - `lastPoint` AssetDataInputLastPoint: The last reported point of a data input.
          - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`.
          - `value` number, double: Numeric value of the data point.
        - `name` string: Name of the data input
        - `units` string: Units of data for this data input
      - `deviceId` string: ID of the device that the data output is configured on
      - `id` string: ID of the data output
      - `name` string: Name of the data output
    - `id` string, required: The id of the asset
    - `isRunning` boolean, required: The running status of the asset. Returns True for On, and False for Off.
    - `location` AssetLocation: For locationType "point", latitude and longitude are required. For "address", formattedAddress must be provided, and lat/long can be optionally included for displaying a dot on the assets map. For "dataInput", this object should not be passed in.
      - `formattedAddress` string: Formatted address of the location
      - `latitude` number, double: The latitude of the asset in decimal degrees.
      - `longitude` number, double: The longitude of the asset in decimal degrees.
    - `locationDataInput` AssetResponseLocationDataInput: The associated location data input (only applicable when locationType is "dataInput").
      - `id` string, required: Id of the data input
    - `locationType` 'point' | 'address' | 'dataInput': The format of the location. This field is required if a location is provided. Valid values: `point`, `address`, `dataInput`.
    - `name` string, required: The name of the asset.
    - `parentAsset` AssetResponseParentAsset: The asset's parent
      - `id` string, required: The id of the parent asset that the asset belongs to.
      - `name` string, required: The name of the asset.
    - `runningStatusDataInput` AssetResponseRunningStatusDataInput: The associated running status data input. isRunning will be true when the data input's value is 1.
      - `id` string, required: Id of the data input
    - `tags` TagTinyResponse[]: The list of [tags](https://kb.samsara.com/hc/en-us/articles/360026674631-Using-Tags-and-Tag-Nesting) associated with the Industrial Asset. **By default**: empty. Can be set or updated through the Samsara Dashboard or the API at any time.
      - `id` string: ID of the tag.
      - `name` string: Name of the tag.
      - `parentTagId` string: If this tag is part a hierarchical tag tree, this is the ID of the parent tag, otherwise this will be omitted.

## Other responses

- `default`: Error response

---

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