--- title: "Update Service Entry" method: PATCH path: "/service_entries/{id}" tags: ["Service Entries"] --- # Update Service Entry `PATCH /service_entries/{id}` ## Request - Base URL: `https://secure.fleetio.com/api` - URL: `https://secure.fleetio.com/api/service_entries/{id}` - Auth: API key in header `Authorization` and API key in header `Account-Token` - TypeScript: (a function with typed inputs; its response is checked against the schema) Update a Service Entry ## Path parameters - `id` string, required ## Request body - object - `completed_at` string, date-time: The date and time at which the Service Entry was completed. We recommend using [ISO-8601](/docs/overview/date-formatting) formatted dates to avoid ambiguity. - `started_at` string, date-time: The date and time at which the Service Entry was started. We recommend using [ISO-8601](/docs/overview/date-formatting) formatted dates to avoid ambiguity. - `vehicle_id` integer - `vehicle_vin` string: The VIN of the `Vehicle` associated with this Service Entry. - `vendor_id` integer - `reference` string: A reference number for this Service Entry. - `label_list` string: A comma separated list of tags associated with this record. The only delimiter allowed is a comma (`,`). Please remove any commas from your labels before saving the record. - `general_notes` string: Any general notes about this Service Entry. - `vmrs_repair_priority_class_id` integer - `custom_fields` CustomFields, nullable: *Full details on working with Custom Fields [here](/docs/overview/custom-fields). - `meter_entry_attributes` object: A Service Entry may be associated with a [Meter Entry](/docs/api/meter-entries) - `value` number, float: The value is the actual number on the meter that increments over time. The unit is determined by the [configured `meter_unit`](https://help.fleetio.com/s/article/Fuel-Settings#vehicle-settings) on the associated Vehicle. - `void` boolean: If you attempt to save a meter value, which is too high or too low, Fleetio's validation rules will reject it. If you need to bypass this validation, you may [mark an entry as void](https://help.fleetio.com/s/article/Meter-Entry-Mark-As-Void-Unmark-As-Void). - `secondary_meter_entry_attributes` object: A Service Entry may also be associated with a secondary [Meter Entry](/docs/api/meter-entries) - `value` number, float: The value is the actual number on the meter that increments over time. The unit is determined by the [configured `meter_unit`](https://help.fleetio.com/s/article/Fuel-Settings#vehicle-settings) on the associated Vehicle. - `void` boolean: If you attempt to save a meter value, which is too high or too low, Fleetio's validation rules will reject it. If you need to bypass this validation, you may [mark an entry as void](https://help.fleetio.com/s/article/Meter-Entry-Mark-As-Void-Unmark-As-Void). - `service_entry_line_items_attributes` ServiceEntryLineItemAttributes[] - `id` integer - `service_task_id` integer - `type` 'ServiceEntryServiceTaskLineItem' | 'ServiceEntryLaborLineItem' | 'ServiceEntryPartLineItem' | 'ServiceEntryTaxLineItem' | 'ServiceEntryFeeLineItem' | 'ServiceEntryTireLineItem' | 'ServiceEntryFreeTextLineItem': Denotes the type of the ServiceEntryLineItem - `description` string: Free text field, used for notes or description. - `labor_cost` number, float: Total labor cost for this line item. - `parts_cost` number, float: Total parts cost for this line item. - `subtotal` number, float: Subtotal for this line item. If `parts_cost` or `labor_cost` are non-zero, this value is ignored. - `service_entry_line_item_id` integer: For nested line items. This value denotes the parent `Service Entry Line Item`. - `issue_ids` string[]: An array of issue IDs that you want the line item to be linked to. This field can be passed several times to the server if you wish to link more than one issue (see cURL example). - `vmrs_reason_for_repair_id` integer - `vmrs_system_group_id` integer - `vmrs_system_id` integer - `vmrs_component_id` integer - `vmrs_assembly_id` integer - `issue_ids` Id[]: The IDs of any Issues associated with this Service Entry. - `service_task_ids` Id[]: The IDs of any Service Tasks associated with this Service Entry. - `comments_attributes` CommentsAttributes[] - `title` string: The title of the comment. - `comment` string: The comment text. - `documents_attributes` object[]: An array of one or more document objects to add to the record. Follow our [Attaching Documents and Images](/docs/overview/attaching-documents-and-images) guide to upload to our third party storage provider in order to obtain `file_url`. - `name` string: The name to give the file which will be shown in the UI. - `file_url` string: The URL obtained from our storage provider that points to the file. - `file_mime_type` string: The MIME type of the file. For example, `application/pdf`. - `file_name` string: The name of the file. - `file_size` integer: The size of the file in bytes. - `images_attributes` object[]: An array of one or more image objects to add to the record. Follow our [Attaching Documents and Images](/docs/overview/attaching-documents-and-images) guide to upload to our third party storage provider in order to obtain `file_url`. - `name` string: The name to give the image which will be shown in the UI. - `file_url` string: The URL obtained from our storage provider that points to the image. - `file_mime_type` string: The MIME type of the image. For example, `image/png`. - `file_name` string: The name of the image. - `file_size` integer: The size of the image file in bytes. - `labor_subtotal` number, float: The total cost of labor for this Service Entry. This is calculated by summing the `labor_cost` of each `Service Entry Line Item`. - `manual_total_amount` boolean: When `true`, preserves the submitted `total_amount` as a manually entered value instead of recalculating it from subtotals, discounts, taxes, fees, and markups. - `manual_parts_or_labor_subtotal` boolean: When `true`, preserves the submitted `parts_subtotal` and `labor_subtotal` as manually entered values instead of recalculating them from `Service Entry Line Item` costs. - `parts_subtotal` number, float: The total cost of `Parts` for this Service Entry. This is calculated by summing the `parts_cost` of each `Service Entry Line Item`. - `subtotal` number, float: The subtotal amount of this Service Entry before any discounts or taxes. This is calculated by summing the `subtotal` of each `Service Entry Line Item`. - `discount` number, float: The total discount amount for this Service Entry. - `discount_percentage` number, float: The total discount percentage for this Service Entry. - `discount_type` 'fixed' | 'percentage', nullable: The type of discount applied to this record. - `tax_1` number, float: The first tax amount for this Service Entry. - `tax_1_percentage` number, float: The first tax percentage for this Service Entry. - `tax_1_type` 'fixed' | 'percentage', nullable: The type of tax to apply to this record. - `tax_2` number, float: The second tax amount for this Service Entry. - `tax_2_percentage` number, float: The second tax percentage for this Service Entry. - `tax_2_type` 'fixed' | 'percentage', nullable: The type of tax to apply to this record. - `total_amount` number, float: The grand total of this Service Entry. ## Response `204` OK ## Other responses - `401`: Request could not be authenticated - `403`: Insufficient permission to perform this operation - `404`: The requested resource could not be located - `422`: Unprocessable Entity - `500`: Something unexpected happened ## Changes - **2026-11-06** `49558d744bd7`: 3 warning, 2 info - the `comments_attributes/items/comment` request property's maxLength was set to `100000` - the `general_notes` request property's maxLength was set to `100000` - the `service_entry_line_items_attributes/items/description` request property's maxLength was set to `100000` - added the new optional request property `manual_parts_or_labor_subtotal` - …1 more [Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/service_entries/:id/patch.md) --- [API](https://skmtc.dev/fleetio/apis/fleetio-developer-api.md) - [All operations](https://skmtc.dev/fleetio/apis/fleetio-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fleetio/apis/fleetio-developer-api/revisions/49558d744bd7?raw)