---
title: "Update an existing asset"
method: PUT
path: "/v1/assets/{id}"
---

# Update an existing asset

`PUT /v1/assets/{id}`

## Path parameters

- `id` integer, required

## Headers

- `X-Time-Zone` string
- `X-Metric-Units` boolean
- `X-User-Id` integer

## Request body

- object
  - `external_ids_attributes` object[] — Specify the external ID as well as the integration name.
    - `id` integer, required — The unique identifier assigned to the external ID.
    - `external_id` string — Specify the external ID of the asset.
    - `integration_name` string — Specify the name of the integration with which the ID is associated.
  - `status` string — Specify the status of the asset. Allowed values are Active or Deactivated.
  - `groups_ids` object
    - integer[] — Specify the IDs of the corresponding groups.
  - `leased` boolean — Specify if the assets are leased or not. TRUE: The asset is leased. FALSE: The asset is not leased.
  - `asset_gateway_id` integer — Specify the ID of the asset gateway to which the asset is linked to.
  - `vin` string — Specify the VIN number of the asset.
  - `availability_details` object
    - `availability_status` string — Denotes the availability status of the vehicle/asset. Allowed values are <ul><li><b>out_of_service</b></li> or <li><b>in_service</b></li></ul>
    - `additional_note` string — Denotes any comments or notes added for updating the availability of the vehicle/asset. For example, “This vehicle/asset is scheduled for maintenance”.
    - `custom_driver_app_warning_prompt` string — This denotes the prompt message that drivers see on their driver_app. This prompt can be used to inform the driver about the status of the vehicle/asset or communicate any specific instructions. For example, “Vehicle/Asset is under maintenance, do not operate. ”

## Response `200`

200

- object
  - `assets` object[]
    - `asset` object
      - `id` integer
      - `name` string
      - `status` string
      - `type` string
      - `custom_type` unknown
      - `vin` unknown
      - `license_plate_state` unknown
      - `license_plate_number` unknown
      - `make` string
      - `model` string
      - `year` string
      - `axle` unknown
      - `weight_metric_units` boolean
      - `length_metric_units` boolean
      - `leased` unknown
      - `notes` unknown
      - `length` unknown
      - `gvwr` unknown
      - `gawr` unknown
      - `asset_gateway` object
        - `id` integer
        - `identifier` string
        - `active` boolean
      - `external_ids` object[]
      - `availability_details` object
        - `availability_status` string
        - `out_of_service_reason` string
        - `updated_at` string
        - `additional_note` string
        - `custom_driver_app_warning_prompt` string
        - `updated_by_user` object
          - `id` integer
          - `first_name` string
          - `last_name` string
          - `user_name` string
          - `email` string
          - `company_reference_id` integer
          - `status` string
          - `role` string
  - `pagination` object
    - `per_page` integer
    - `page_no` integer
    - `total` integer

---

[API](https://skmtc.net/gomotive/apis/motive.md) · [All operations](https://skmtc.net/gomotive/apis/motive/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gomotive/motive/versions/c71780e497f5/schema)