Update Equipment
PATCHhttps://secure.fleetio.com/api/v1/equipment/:id
Update a Equipment
Request
Path Parameters
Possible values: Value must match regular expression ^[0-9]+$
The id of the relevant record
- application/json
Body
The name for this Equipment.
The name of the brand which makes this Equipment.
The model name of this Equipment.
The serial number of this Equipment.
Possible values: >= 1
Possible values: >= 1
Possible values: >= 1
A pipe delimited group hierarchy. Ex: "Level 1|Level 2|Level 3". Where Level 1 is the parent of Level 2, and 2 is the parent of 3. Any missing nodes in the hierarchy will be created.
Possible values: >= 1
The price at which the Equipment was purchased.
The date on which the Equipment warranty expires.
2023-03-14
Any comments about the purchase of this Equipment.
We recommend using ISO-8601 formatted dates to avoid ambiguity.
2023-03-14
The estimated duration in months of the service life for this Equipment.
The estimated resale price of this Equipment.
We recommend using ISO-8601 formatted dates to avoid ambiguity.
2023-03-14
Possible values: >= 1
Possible values: >= 1
The default image URL for this Equipment.
*Full details on working with Custom Fields here.
documents_attributes object[]
images_attributes object[]
Responses
- 200
- 401
- 403
- 422
- 500
OK
Response Headers
- application/json
- Schema
- Example (auto)
Schema
Possible values: >= 1
The date and time at which this record was created.
2023-03-14T13:46:27-06:00
The date and time at which this record was most recently updated.
2023-03-14T13:46:27-06:00
The name for this Equipment.
The name of the brand which makes this Equipment.
The model name of this Equipment.
The serial number of this Equipment.
Possible values: >= 1
The name of the associated Equipment Type
.
Possible values: >= 1
The name of the associated Equipment Status
.
Possible values: >= 1
The name of the associated Group
.
Possible values: >= 1
The purchase price in cents.
The date on which the Equipment was purchased.
2023-03-14
The estimated resale price of this Equipment.
The date on which the Equipment warranty expires.
2023-03-14
Any comments about the purchase of this Equipment.
*Full details on working with Custom Fields here.
The date on which the Equipment was put into service.
2023-03-14
The estimated duration in months of the service life for this Equipment.
The estimated date on which the Equipment will be retired from service.
2023-03-14
The date and time at which the Equipment was archived.
The color of the associated Equipment Status
.
linked_vehicle objectnullablerequired
assigned_contact objectnullablerequired
attachment_permissions objectnullablerequired
The URL of the Equipment's default image/profile photo, if any.
The type of assetable object.
The number of Issues
associated with this Equipment.
current_location_entry objectnullablerequired
The number of Comments
associated with this Equipment.
Possible values: >= 0
The number of documents associated with this Equipment.
Possible values: >= 0
The number of images associated with this Equipment.
Possible values: >= 0
Indicates whether this Equipment is being watched.
false
The number of users watching this Equipment.
Possible values: >= 0
{
"id": 0,
"created_at": "2023-03-14T13:46:27-06:00",
"updated_at": "2023-03-14T13:46:27-06:00",
"name": "string",
"brand": "string",
"model": "string",
"serial_number": "string",
"equipment_type_id": 0,
"type_name": "string",
"equipment_status_id": 0,
"status_name": "string",
"group_id": 0,
"group_name": "string",
"purchase_vendor_id": 0,
"purchase_price_cents": 0,
"purchase_date": "2023-03-14",
"estimated_resale_price": 0,
"warranty_expiration_date": "2023-03-14",
"purchase_comments": "string",
"custom_fields": {},
"in_service_date": "2023-03-14",
"estimated_service_life": 0,
"out_of_service_date": "2023-03-14",
"archived_at": "2024-07-29T15:51:28.071Z",
"status_color": "string",
"linked_vehicle": {
"id": 0,
"created_at": "2024-07-29T15:51:28.071Z",
"updated_at": "2024-07-29T15:51:28.071Z",
"account_id": 0,
"archived_at": "2023-03-14T13:46:27-06:00",
"fuel_type_id": 0,
"fuel_type_name": "string",
"fuel_volume_units": "us_gallons",
"group_id": 0,
"group_name": "string",
"meter_unit": "km",
"name": "string",
"ownership": "Owned",
"secondary_meter": true,
"secondary_meter_unit": "km",
"system_of_measurement": "imperial",
"labels": [
{
"id": 0,
"name": "string",
"color": "#44DB38"
}
],
"vehicle_status_id": 0,
"vehicle_status_name": "string",
"vehicle_status_color": "string",
"vehicle_type_id": 0,
"vehicle_type_name": "string",
"fuel_entries_count": 0,
"service_entries_count": 0,
"service_reminders_count": 0,
"vehicle_renewal_reminders_count": 0,
"comments_count": 0,
"documents_count": 0,
"images_count": 0,
"current_location_entry_id": 0,
"is_sample": true,
"in_service_date": "2023-03-14T13:46:27-06:00",
"in_service_meter": 0,
"estimated_service_months": 0,
"estimated_replacement_mileage": "string",
"estimated_resale_price": {
"cents": 0,
"currency_iso": "string"
},
"out_of_service_date": "2023-03-14T13:46:27-06:00",
"out_of_service_meter": 0,
"meter_name": "string",
"secondary_meter_name": "string",
"primary_meter_usage_per_day": "string",
"secondary_meter_usage_per_day": "string",
"current_meter_value": 0,
"current_meter_date": "2023-03-14T13:46:27-06:00",
"secondary_meter_value": 0,
"secondary_meter_date": "2023-03-14T13:46:27-06:00",
"group_ancestry": "string",
"color": "string",
"license_plate": "string",
"vin": "string",
"year": "string",
"make": "string",
"model": "string",
"trim": "string",
"registration_expiration_month": 0,
"registration_state": "string",
"loan_account_number": "string",
"loan_ended_at": "2023-03-14T13:46:27-06:00",
"loan_interest_rate": 0,
"loan_notes": "string",
"loan_started_at": "2023-03-14T13:46:27-06:00",
"loan_vendor_id": 0,
"loan_vendor_name": "string",
"custom_fields": {},
"inspection_schedules_count": 0,
"issues_count": 0,
"work_orders_count": 0,
"type_name": "string",
"default_image_url": "string",
"default_image_url_medium": "string",
"default_image_url_small": "string",
"default_image_url_large": "string",
"specs": {
"id": 0,
"vehicle_id": 0,
"account_id": 0,
"body_type": "string",
"body_subtype": "string",
"drive_type": "string",
"brake_system": "string",
"msrp_cents": 0,
"fuel_tank_capacity": 0,
"fuel_tank_2_capacity": 0,
"front_track_width": 0,
"ground_clearance": 0,
"height": 0,
"length": 0,
"rear_track_width": 0,
"width": 0,
"wheelbase": 0,
"front_tire_psi": "string",
"rear_tire_psi": "string",
"base_towing_capacity": "string",
"curb_weight": 0,
"gross_vehicle_weight_rating": 0,
"bed_length": "string",
"max_payload": "string",
"rear_axle_type": "string",
"front_tire_type": "string",
"front_wheel_diameter": "string",
"rear_tire_type": "string",
"rear_wheel_diameter": "string",
"epa_city": 0,
"epa_highway": 0,
"epa_combined": 0,
"engine_description": "string",
"engine_brand": "string",
"engine_aspiration": "string",
"engine_block_type": "string",
"engine_bore": "string",
"engine_cam_type": "string",
"engine_compression": "string",
"engine_cylinders": 0,
"engine_displacement": "string",
"fuel_induction": "string",
"fuel_quality": "string",
"max_hp": "string",
"max_torque": "string",
"oil_capacity": "string",
"redline_rpm": "string",
"engine_stroke": "string",
"engine_valves": 0,
"transmission_description": "string",
"transmission_brand": "string",
"transmission_type": "string",
"transmission_gears": 0,
"cargo_volume": 0,
"interior_volume": 0,
"passenger_volume": "string",
"created_at": "2024-07-29T15:51:28.071Z",
"updated_at": "2024-07-29T15:51:28.071Z",
"duty_type": "string",
"weight_class": "string",
"engine_bore_with_units": "string",
"wheelbase_with_units": "string",
"msrp": "string"
},
"external_ids": {},
"ai_enabled": true,
"assetable_type": "Vehicle",
"driver": {
"id": 0,
"first_name": "string",
"last_name": "string",
"full_name": "string",
"default_image_url": "string"
},
"current_location_entry": {
"id": 0,
"locatable_type": "string",
"locatable_id": 0,
"date": "2024-07-29T15:51:28.071Z",
"created_at": "2024-07-29T15:51:28.071Z",
"updated_at": "2024-07-29T15:51:28.071Z",
"contact_id": 0,
"address": "string",
"is_current": true,
"item_type": "string",
"item_id": 0,
"location": "string",
"address_components": {
"street_number": "string",
"street": "string",
"city": "string",
"region": "string",
"region_short": "string",
"country": "string",
"country_short": "string",
"postal_code": "string"
},
"geolocation": {
"latitude": 0,
"longitude": 0
}
},
"loan_amount": 0,
"loan_payment": 0,
"warranties_active_count": 0,
"warranties_count": 0,
"residual_value": 0,
"axle_config_id": 0
},
"assigned_contact": {
"id": 0,
"created_at": "2024-07-29T15:51:28.071Z",
"updated_at": "2024-07-29T15:51:28.071Z",
"email": "string",
"name": "string",
"first_name": "string",
"middle_name": "string",
"last_name": "string",
"images_count": 0,
"documents_count": 0,
"comments_count": 0,
"group_id": 0,
"group_name": "string",
"group_hierarchy": "Group 1|Group 2|Group 3",
"technician": true,
"vehicle_operator": true,
"employee": true,
"birth_date": "2023-03-14",
"street_address": "123 Main St",
"street_address_line_2": "Apt 1",
"city": "string",
"region": "string",
"postal_code": "string",
"country": "string",
"employee_number": "string",
"job_title": "string",
"license_class": "string",
"license_number": "string",
"license_state": "string",
"license_expiration": "2023-03-14",
"home_phone_number": "string",
"mobile_phone_number": "string",
"work_phone_number": "string",
"other_phone_number": "string",
"start_date": "2024-07-29",
"leave_date": "2024-07-29",
"hourly_labor_rate": 0,
"custom_fields": {},
"attachment_permissions": {
"read_photos": true,
"manage_photos": true,
"read_documents": true,
"manage_documents": true
},
"default_image_url": "string",
"user": {},
"account_membership_id": 0,
"last_api_request": "2024-07-29T15:51:28.071Z",
"last_web_access": "2024-07-29T15:51:28.071Z",
"last_mobile_app_access": "2024-07-29T15:51:28.071Z"
},
"attachment_permissions": {
"read_photos": true,
"manage_photos": true,
"read_documents": true,
"manage_documents": true
},
"default_image_url": "string",
"assetable_type": "string",
"issues_count": 0,
"current_location_entry": {
"id": 0,
"locatable_type": "string",
"locatable_id": 0,
"date": "2024-07-29T15:51:28.071Z",
"created_at": "2024-07-29T15:51:28.071Z",
"updated_at": "2024-07-29T15:51:28.071Z",
"contact_id": 0,
"address": "string",
"is_current": true,
"item_type": "string",
"item_id": 0,
"location": "string",
"address_components": {
"street_number": "string",
"street": "string",
"city": "string",
"region": "string",
"region_short": "string",
"country": "string",
"country_short": "string",
"postal_code": "string"
},
"geolocation": {
"latitude": 0,
"longitude": 0
}
},
"comments_count": 0,
"documents_count": 0,
"images_count": 0,
"is_watched": false,
"watchers_count": 0
}
Request could not be authenticated
- application/json
- Schema
- Example (auto)
Schema
Possible values: >= 400
and <= 599
A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
A human-readable explanation specific to this occurrence of the problem.
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"status": 0,
"title": "string",
"detail": "string",
"instance": "string"
}
Insufficient permission to perform this operation
- application/json
- Schema
- Example (auto)
Schema
Possible values: >= 400
and <= 599
A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
A human-readable explanation specific to this occurrence of the problem.
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"status": 0,
"title": "string",
"detail": "string",
"instance": "string"
}
Unprocessable Entity
- application/json
- Schema
- Example (auto)
- Example
Schema
errors object
{
"errors": {}
}
{
"errors": {
"field1": [
"error1",
"error2"
],
"field2": [
"error3"
]
}
}
Something unexpected happened
- application/json
- Schema
- Example (auto)
Schema
Possible values: >= 400
and <= 599
A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
A human-readable explanation specific to this occurrence of the problem.
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"status": 0,
"title": "string",
"detail": "string",
"instance": "string"
}
Authorization: Authorization
name: Authorizationtype: apiKeyin: headerdescription: Prefix the value with "Token", for example: "Token 76cbe06c49a64". You can generate a new API key [here](https://secure.fleetio.com/api_keys).
name: Account-Tokentype: apiKeyin: headerdescription: You can find your Account-Token [here](https://secure.fleetio.com/api_keys)
- curl
- ruby
- python
- csharp
- go
- java
- nodejs
- php
- CURL