---
title: "Update a line item"
method: POST
path: "/v1/line_items/{line_item_id}"
tags: ["Line items"]
---

# Update a line item

`POST /v1/line_items/{line_item_id}`

## Path parameters

- `line_item_id` string, required

## Request body

- UpdateLineItemRowRequest — Request schema for updating a line item row. All fields are optional. Omitting a field leaves it unchanged. Some fields may be explicitly set to null to clear the value.
  - `title` string — Updated line item title. Omit to leave unchanged.
  - `description` string — Updated line item description. Omit to leave unchanged.
  - `notes` string, nullable — Line item notes. Set to null to clear. Omit to leave unchanged.
  - `status` 'not_complete' | 'complete' | 'rejected' — Updated line item status. Omit to leave unchanged.
  - `rejection_reason_option_id` string, nullable — ID of the selected [rejection reason option](/api-reference/rejection-reason-options/rejection-reason-option-object). May only be set when the resulting line item status is `rejected`. Will be cleared otherwise. Omit to leave unchanged.
  - `rejection_reason_text` string, nullable — Free text rejection reason for additional context. May only be set when the resulting line item status is `rejected`. Will be cleared otherwise. Omit to leave unchanged.
  - `cost_components` CostComponentExternalSchema[], nullable — Granular cost breakdown. Replaces the line item's existing components in full. Omit to leave unchanged.
    - `kind` 'total' | 'labor' | 'material', required — The type of cost component: "total", "labor", or "material".
    - `label` string, nullable — Optional display label for this component.
    - `unit_type` string, nullable — Unit of measurement (e.g. "each", "sqft"). Defaults to "each" if omitted.
    - `unit_cost_in_cents` integer, nullable — Cost per unit in cents.
    - `quantity` string, required — Number of units as a decimal string (e.g. "1", "2.5").
  - `price_override_reason` string, nullable — Justification recorded alongside a `cost_components` change. Required when your organization mandates a reason for the changed cost component kinds. Only applies when `cost_components` is provided.

## Response `200`

OK

- LineItemRowApiResponse
  - `line_item_row` LineItemRowExternalSchema, required
    - `id` string, required
    - `line_item_row_id` string, required — The stable location-level line item ID.
    - `title` string, required
    - `description` string, required
    - `status` 'suggested' | 'not_complete' | 'complete' | 'rejected', required
    - `quantity` integer, required — Deprecated: Use cost_components instead. Total quantity (integer).
    - `unit_type` string, required — Deprecated: Use cost_components instead. Unit of measurement (e.g. "each", "sqft").
    - `unit_cost_cents` integer, nullable, required — Deprecated: Use cost_components instead. Cost per unit in cents.
    - `cost_components` CostComponentExternalSchema[], required — Granular cost breakdown. Replaces the legacy quantity/unit_type/unit_cost_cents fields.
      - `kind` 'total' | 'labor' | 'material', required — The type of cost component: "total", "labor", or "material".
      - `label` string, nullable — Optional display label for this component.
      - `unit_type` string, nullable — Unit of measurement (e.g. "each", "sqft"). Defaults to "each" if omitted.
      - `unit_cost_in_cents` integer, nullable — Cost per unit in cents.
      - `quantity` string, required — Number of units as a decimal string (e.g. "1", "2.5").
    - `price_override_reason` string, nullable — The reason recorded when a cost component's price was overridden (e.g. a labor cost change), if a reason was provided. Reflects the most recent price override. Null when no reason was recorded.
    - `price_reference_key` string, nullable, required — Your external identifier for the pricing item used.
    - `notes` string, required
    - `custom_fields` object, required
    - `evidence` union[], required — Supporting evidence — images, audio segments, or text notes.
      - union
        - ImageEvidenceExternalSchema
          - `type` 'image'
          - `image_id` string, required — Use with the Get Image endpoint to retrieve the image file.
          - `reference_key` string, nullable
          - `visit_id` string, nullable — The visit this image was captured during.
          - `is_selected` boolean — Whether this image was explicitly selected as evidence.
          - `is_starred` boolean — Whether this image was starred as the primary evidence photo.
        - AudioEvidenceExternalSchema
          - `type` 'audio'
          - `start_ms` integer, required — Start timestamp in the source video, in milliseconds.
          - `end_ms` integer, required — End timestamp in the source video, in milliseconds.
          - `text` string, required — Transcribed text from this audio segment.
        - TextEvidenceExternalSchema
          - `type` 'text'
          - `text` string, required
    - `area_name` string, nullable, required — Deprecated: Use room.name instead. The room or area this line item applies to.
    - `room` LineItemRoomExternalSchema, required — The room or area a line item applies to.
      - `name` string, required — Display name of the room or area (e.g. 'Bedroom 2', 'Kitchen'). Not guaranteed to be stable over time.
      - `room_type_id` string, nullable — The [room type](/api-reference/room-types/room-type-object) ID.
    - `rejection_reason_option_id` string, nullable — ID of the selected [rejection reason option](/api-reference/rejection-reason-options/rejection-reason-option-object), if applicable.
    - `rejection_reason_text` string, nullable — Reason the line item was rejected, if applicable.
    - `vendor` VendorOrganizationExternalSchema
      - `id` string, required
      - `name` string, required
      - `email` string, nullable, required
      - `reference_key` string, required — Optional unique identifier for this vendor in your system.
      - `is_enabled` boolean, required — Whether this vendor is enabled.
      - `market_ids` string[], required — IDs of the markets this vendor serves. A vendor with no market associations serves all markets.

---

[API](https://skmtc.net/navigateai/apis/navigateai-api.md) · [All operations](https://skmtc.net/navigateai/apis/navigateai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/navigateai/navigateai-api/revisions/5fb236d03a88/schema)