> ## Documentation Index > Fetch the complete documentation index at: https://docs.upwell.com/llms.txt > Use this file to discover all available pages before exploring further. # Update a shipment line item > Update a shipment line item by its `sli_` ID. Send only the fields you want to change — omitted fields keep their stored values. ## OpenAPI ````yaml /api-reference/openapi.json patch /api/rest/shipment_line_items/{id} openapi: 3.1.0 info: description: >- Upwell is Accounts Receivable automation software for the logistics industry. We serve freight brokers, carriers, factors, and anyone who needs to get transportation invoices paid. Learn more at: - [Upwell.com](https://upwell.com) title: Upwell REST API version: 3.34.0 termsOfService: https://upwell.com/legal contact: name: Upwell url: https://upwell.com email: contact@upwell.com servers: - url: https://api.upwell.com description: Production server - url: https://staging.api.upwell.com description: Staging server security: - ApiKeyAuth: [] tags: - name: Addresses description: >- **Core.** A typed physical address owned by one parent record — a customer, carrier, company, contact, or a shipment's pickup/consignee slot. Addresses are **not** shared master data: they are never deduplicated by content, and they carry no `sourceSystem`/`sourceSystemId`, so store the returned `addr_` id yourself. Embed an address when you create its parent; update it in a separate call. See [Working with addresses](/conventions/addresses). - name: Bill Line Items description: >- **Accounts payable.** Priced rows on a bill. Create, update, and delete only — there is no list endpoint, so read them through the parent bill. - name: Bill Payments description: >- **Accounts payable.** A payment that settles what you owe a carrier. A bill payment has no direct link to a bill — the relationship runs through its line items. See [Recording carrier payments](/api-guides/carrier-invoice-submission#recording-carrier-payments). - name: Bills description: >- **Accounts payable.** The expected payable synced from your TMS — what Upwell audits an incoming carrier invoice against. A bill is owed to *either* a carrier *or* a vendor, never both. See [Syncing foundation entities](/api-guides/syncing-foundation-entities). - name: Carrier Invoice Approval Requests description: >- **Accounts payable.** A pending approval decision Upwell hands to your system to resolve. See [Responding to an approval request](/api-guides/carrier-invoice-approval). - name: Carrier Invoice Documents description: >- **Accounts payable.** Documents attached to a carrier invoice — the invoice scan, BOL, POD, notice of assignment. Listed separately from **Carrier Invoices** because these operate on the document list rather than the invoice record itself. - name: Carrier Invoices description: >- **Accounts payable.** What a carrier actually billed you — the received payable, as opposed to the expected **Bill**. Create is de-duplicated **asynchronously**, not on the request, so a retry can briefly create a live duplicate: read [Re-submitting](/api-guides/carrier-invoice-submission#re-submitting) before you build retry logic. - name: Carrier Payment Line Items description: >- **Accounts payable.** How a bill payment splits across the bills it settles — the payables counterpart to **Customer Payment Line Items**. Build against `billId`. `billPaymentId` is **not** writable over the API by any role — the column exists on the table but is granted to none of them, so it is not part of the public insert input. - name: Carriers description: >- **Core.** Who hauls the freight and gets paid. Unlike customers, re-posting an existing `(sourceSystem, sourceSystemId)` pair **silently succeeds without updating any other field** — use `PUT` to change an existing carrier. See [Syncing foundation entities](/api-guides/syncing-foundation-entities). - name: Companies description: >- **Core.** **Your own** legal-entity or division record — *not* a customer. If you are looking for the party you bill and collect from, use **Customers** instead. Most integrations need only one company and rarely touch this endpoint. - name: Customer Payment Line Items description: >- **Accounts receivable.** How one customer payment splits across the invoices it pays — the unit that makes cash application work when a single check covers many invoices. - name: Customer Payments description: >- **Accounts receivable.** An incoming remittance from a customer, applied to invoices through its line items. Line-item amounts need not sum to the payment total — a remittance can be partially applied and reconciled later. See [Recording customer payments](/api-guides/customer-payments). - name: Customers description: >- **Core.** Who you bill and collect from (the shipper). Re-posting an existing `(sourceSystem, sourceSystemId)` pair returns `400 Uniqueness violation` — use `PUT` to update. **Deleting a customer also deletes their invoices**, so deactivate rather than delete. - name: Document Reference Specifications description: >- **Core.** Per-customer (or tenant-wide) rules describing what a reference number should look like, used to validate a reference's label and format. A niche configuration object that most integrations never need to touch. - name: Documents description: >- **Core.** A file — BOL, POD, rate confirmation, invoice scan. Usually attached to a shipment, invoice, or carrier invoice, though purchase orders and vendor invoices are uploaded standalone. Use the [two-step presigned-URL flow](/conventions/documents#document-upload-two-step-presigned-url) for anything large or unclassified. - name: Invoice Approval description: >- **Accounts receivable.** Queue and approval endpoints for customer invoices awaiting sign-off before they are delivered. - name: Invoice Documents description: >- **Accounts receivable.** Documents attached to a customer invoice. Documents already on a linked shipment appear on the invoice automatically, so you usually do not need to upload them twice. - name: Invoice Line Items description: >- **Accounts receivable.** Priced rows on a customer invoice — line haul, fuel surcharge, accessorials. They sum to the invoice total. - name: Invoice Shipments description: >- **Accounts receivable.** The link between a customer invoice and the shipments it bills. Use these endpoints to add or remove a shipment **after** the invoice already exists; linking or unlinking triggers a background re-sync of that shipment's documents onto the invoice. - name: Invoices description: >- **Accounts receivable.** What you bill your customer. An unqualified "invoice" always means this one — the customer/AR invoice, never the carrier's. See [Managing customer invoices](/api-guides/customer-invoices). - name: Purchase Orders description: >- **Accounts payable.** Inbound customer purchase orders parsed from a standalone PDF upload, including combined PDFs that Upwell splits into one record per document. See [Purchase orders and vendor invoices](/api-guides/purchase-orders-and-vendor-invoices). - name: Rules description: >- **Core.** Configurable if-this-then-that policies Upwell evaluates during processing — require a document, raise an exception, route by SCAC. Which fields you populate depends on the rule's `type`; see [Rules: three shapes](/conventions/rules). - name: Shipment Documents description: >- **Core.** Documents attached to a shipment. These propagate to invoices linked to that shipment, so uploading once is usually enough. See [Working with shipment documents](/api-guides/shipment-documents). - name: Shipment Line Items description: >- **Core.** Cargo and freight metadata on a shipment — commodity description, NMFC class, handling units, package counts, weight, hazmat flag. **Not** priced rows: unlike invoice, bill, and payment line items, these carry no rate or amount field at all. - name: Shipments description: >- **Core.** The freight movement (load) — the hub that invoices, bills, and documents hang off. `shipmentId` is required and has no server default. Pickup and consignee addresses can be embedded on create or attached later via `pickupAddressId`/`consigneeAddressId` on update — both are accepted even though this reference currently under-reports the update input. See [Working with addresses](/conventions/addresses). - name: Stops description: >- **Core.** Ordered points on a shipment's route — pickup, delivery, terminal, cross-dock. Populate `stopType`; the separate constrained `type` field is only partially adopted in practice. Deleting a shipment deletes its stops. - name: Vendor Invoices description: >- **Accounts payable.** Generic, non-freight vendor AP invoices parsed from a standalone PDF upload, matched to a **Purchase Order** when one exists. See [Purchase orders and vendor invoices](/api-guides/purchase-orders-and-vendor-invoices). - name: Vendors description: >- **Accounts payable.** A payable party that isn't a hauling carrier — a lumper service, a factor, a non-freight supplier. Both `sourceSystem` and `sourceSystemId` are required. Delete is **permanent** (there is no soft delete) and fails while any bill still references the vendor. paths: /api/rest/shipment_line_items/{id}: patch: summary: Update a shipment line item description: >- Update a shipment line item by its `sli_` ID. Send only the fields you want to change — omitted fields keep their stored values. parameters: - description: _"id" is required (enter it either in parameters or request body)_ in: path name: id schema: type: string required: true requestBody: content: application/json: schema: properties: id: nullable: false title: String type: string input: $ref: '#/components/schemas/ShipmentLineItemsSetInput' type: object description: >- Query parameters can also be provided in the request body as a JSON object required: true responses: '200': content: application/json: schema: properties: updateShipmentLineItem: description: Shipment Line Items nullable: true properties: commodityDescription: nullable: true title: String type: string createdAt: $ref: '#/components/schemas/timestamp' deliveryLocationName: nullable: true title: String type: string dimensionUnit: nullable: true title: String type: string freightClass: nullable: true title: String type: string handlingUnit: nullable: true title: String type: string handlingUnitQty: $ref: '#/components/schemas/numeric' handlingUnitType: $ref: '#/components/schemas/EdiHandlingUnitTypeEnum' hazmatFlag: nullable: true title: Boolean type: boolean height: $ref: '#/components/schemas/numeric' id: nullable: false title: String type: string length: $ref: '#/components/schemas/numeric' lineNumber: nullable: false title: Int type: integer nmfcClass: nullable: true title: String type: string nmfcNumber: nullable: true title: String type: string packageQty: $ref: '#/components/schemas/numeric' packageType: $ref: '#/components/schemas/EdiHandlingUnitTypeEnum' packageUnit: nullable: true title: String type: string pickupLocationName: nullable: true title: String type: string referenceNumber: nullable: true title: String type: string shipmentId: nullable: false title: String type: string sourceSystem: nullable: true title: String type: string sourceSystemId: nullable: true title: String type: string updatedAt: $ref: '#/components/schemas/timestamp' weight: $ref: '#/components/schemas/numeric' weightUnit: nullable: true title: String type: string weightUnitType: $ref: '#/components/schemas/EdiWeightUnitTypeEnum' width: $ref: '#/components/schemas/numeric' title: ShipmentLineItems type: object description: Responses for PATCH /api/rest/shipment_line_items/{id} '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' components: schemas: ShipmentLineItemsSetInput: description: input type for updating data in table "shipment_line_items" nullable: false properties: commodityDescription: nullable: true title: String type: string createdAt: $ref: '#/components/schemas/timestamp' deletedAt: $ref: '#/components/schemas/timestamp' deliveryLocationName: nullable: true title: String type: string dimensionUnit: nullable: true title: String type: string freightClass: nullable: true title: String type: string handlingUnit: nullable: true title: String type: string handlingUnitQty: $ref: '#/components/schemas/numeric' handlingUnitType: $ref: '#/components/schemas/EdiHandlingUnitTypeEnum' hazmatFlag: nullable: true title: Boolean type: boolean height: $ref: '#/components/schemas/numeric' id: nullable: true title: String type: string length: $ref: '#/components/schemas/numeric' lineNumber: nullable: true title: Int type: integer nmfcClass: nullable: true title: String type: string nmfcNumber: nullable: true title: String type: string packageQty: $ref: '#/components/schemas/numeric' packageType: $ref: '#/components/schemas/EdiHandlingUnitTypeEnum' packageUnit: nullable: true title: String type: string pickupLocationName: nullable: true title: String type: string referenceNumber: nullable: true title: String type: string shipmentId: nullable: true title: String type: string sourceSystem: nullable: true title: String type: string sourceSystemId: nullable: true title: String type: string updatedAt: $ref: '#/components/schemas/timestamp' weight: $ref: '#/components/schemas/numeric' weightUnit: nullable: true title: String type: string weightUnitType: $ref: '#/components/schemas/EdiWeightUnitTypeEnum' width: $ref: '#/components/schemas/numeric' title: ShipmentLineItemsSetInput type: object timestamp: nullable: false title: timestamp numeric: nullable: false title: numeric EdiHandlingUnitTypeEnum: enum: - BAG - BLK - BOB - BOT - BOX - BRG - BSK - BXI - BXT - CAB - CAG - CAN - CAR - CAS - CBC - CBY - CCS - CHE - CHS - CLD - CNA - CNB - CNC - CND - CNE - CNF - CNT - CNX - COL - CON - COR - CRD - CRT - CSK - CTN - CUB - CYL - DBK - DRK - DRM - DSK - DTB - DUF - ENV - FIR - FLO - FLX - FRM - FSK - FWR - GOH - HED - HGH - HPR - HPT - HRB - HRK - HTB - JAR - JUG - KEG - KIT - KRK - KTB - LBK - LIF - LOG - LSE - LUG - LVN - MLV - MRP - MSV - MXD - NOL - OVW - PAL - PCK - PCS - PIR - PKG - PLF - PLL - PLN - PLT - POV - PRK - QTR - RAL - RCK - REL - ROL - RVR - SAK - SBC - SCS - SHK - SHT - SID - SKD - SKE - SLP - SLV - SPI - SPL - SVN - TBE - TBN - TKR - TKT - TLD - TNK - TRC - TRI - TRK - TRU - TRY - TSS - TTC - UNT nullable: false title: EdiHandlingUnitTypeEnum EdiWeightUnitTypeEnum: enum: - CG - CT - CWT - DAG - DG - DTN - DWT - G - GR - HG - KG - KT - LB - LT - MG - MT - ONZ - OZ - Q - ST - T - UG nullable: false title: EdiWeightUnitTypeEnum responses: BadRequestError: description: >- Malformed or invalid request — missing required field, duplicate external key, wrong payload wrapper, or non-integer money. The body is a flat error object. content: application/json: schema: type: object properties: error: type: string description: Human-readable error message naming the problem. code: type: string description: >- Machine-readable category when present (e.g. `constraint-violation`, `bad-request`). example: error: >- Not-NULL violation. null value in column "shipment_id" of relation "shipments" violates not-null constraint code: constraint-violation UnauthorizedError: description: Missing, invalid, or revoked API key. The response body is empty. securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization description: >- Your API key, sent in the `Authorization` header: `Authorization: YOUR_API_KEY`. A `Bearer ` prefix is also accepted (`Authorization: Bearer YOUR_API_KEY`). Keys are created in the Upwell dashboard (Account → API keys) and are scoped to one organization. ````