> For the complete documentation index, see [llms.txt](https://docs.imperialcad.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.imperialcad.app/api-and-integrations/api-integrations/civilian-endpoints/edit-vehicle.md).

# Edit Vehicle

This endpoint allows you to update vehicle information inside ImperialCAD.

This is intended for integrations that need to sync vehicle changes from an in-game framework, garage system, MDT, or other external resource into ImperialCAD.

This endpoint can update a vehicle’s plate, color, stolen status, and insurance status.

{% hint style="warning" %}
This endpoint requires **an Advanced** ImperialCAD subscription or higher.
{% endhint %}

### editvehicle

`POST` `https://imperialcad.app/api/1.1/wf/editvehicle`

***

### Request Body

| Name             | Type    | Description                                     |
| ---------------- | ------- | ----------------------------------------------- |
| `commId`         | string  | Your ImperialCAD community ID                   |
| `vin`            | string  | The VIN of the vehicle being updated            |
| `data`           | object  | Object containing the vehicle fields to update  |
| `data.plate`     | string  | Updated vehicle plate                           |
| `data.color`     | string  | Updated vehicle color                           |
| `data.isStolen`  | boolean | Whether the vehicle should be marked as stolen  |
| `data.isInsured` | boolean | Whether the vehicle should be marked as insured |

***

### Headers

Use the standard ImperialCAD API headers shown in the API Getting Started documentation.

***

{% tabs %}
{% tab title="Example" %}

```lua
{
  "commId": "1723018855907x983892761338183700",
  "vin": "Z57SM7X7WKLW8AM0Z",
  "data": {
    "plate": "123ABC",
    "color": "Green",
    "isStolen": true,
    "isInsured": false
  }
}
```

{% endtab %}

{% tab title="Response of Example" %}

```lua
{
  "status": "success"
}
```

{% endtab %}
{% endtabs %}

***

### Notes

This endpoint updates an existing vehicle using the provided community ID and VIN.

The VIN is used as the unique vehicle identifier. Developers should store the ImperialCAD vehicle VIN when syncing vehicle records with external systems.

Only the fields provided inside the `data` object are intended to be updated by this endpoint.

Use `isStolen` to control whether the vehicle is marked stolen in ImperialCAD.

Use `isInsured` to control whether the vehicle is marked insured in ImperialCAD.