Sign in
Transactions

Update a transaction item

Updates a transaction item. Read-only fields return 422 field_read_only.

patch/transactions/{transactionId}/items/{itemId}

Request

  • Base URL: https://next-api.saturation.io/v1
  • URL: https://next-api.saturation.io/v1/transactions/{transactionId}/items/{itemId}
  • Auth: HTTP bearer

Path parameters

transactionIdstring required

A stable resource ID, such as prj_…, txn_…, or doc_….

Example:txn_8f2a1c9e

Transaction ID.

itemIdstring required

A stable resource ID, such as prj_…, txn_…, or doc_….

Example:txn_8f2a1c9e

Transaction item ID.

Request body

lineNumberstring nullable
descriptionstring nullable
budgetLineIdstring

A stable resource ID, such as prj_…, txn_…, or doc_….

fringeIdstring

A stable resource ID, such as prj_…, txn_…, or doc_….

contactIdstring

A stable resource ID, such as prj_…, txn_…, or doc_….

qtystring nullable
unitstring nullable
customUnitIdstring

A stable resource ID, such as prj_…, txn_…, or doc_….

ratestring nullable
overtimestring nullable
taxablestring nullable
nonTaxablestring nullable
tagIdsId[]

Replaces the item's tags. Send an empty array to remove all tags.

Example request

{
  "budgetLineId": "txn_8f2a1c9e",
  "fringeId": "txn_8f2a1c9e",
  "contactId": "txn_8f2a1c9e",
  "customUnitId": "txn_8f2a1c9e",
  "amount": {
    "amount": 152900,
    "currency": "USD"
  },
  "tagIds": [
    "txn_8f2a1c9e"
  ]
}

Response

The updated item.

idstring required

A stable resource ID, such as prj_…, txn_…, or doc_….

lineNumberstring nullable required

Line number shown in the itemization.

descriptionstring nullable

Item description.

budgetLineIdstring

A stable resource ID, such as prj_…, txn_…, or doc_….

fringeIdstring

A stable resource ID, such as prj_…, txn_…, or doc_….

contactIdstring

A stable resource ID, such as prj_…, txn_…, or doc_….

qtystring nullable

Quantity or formula.

unitstring nullable

Unit, such as Day, Hour, or Flat.

customUnitIdstring

A stable resource ID, such as prj_…, txn_…, or doc_….

ratestring nullable

Rate or formula.

overtimestring nullable

Overtime amount or formula.

taxablestring nullable

Taxable amount or formula.

nonTaxablestring nullable

Non-taxable amount or formula.

tagIdsId[] required

Tag IDs assigned to this item.

Example response

{
  "id": "txn_8f2a1c9e",
  "lineNumber": "1",
  "budgetLineId": "txn_8f2a1c9e",
  "fringeId": "txn_8f2a1c9e",
  "contactId": "txn_8f2a1c9e",
  "qty": "3",
  "unit": "Day",
  "customUnitId": "txn_8f2a1c9e",
  "amount": {
    "amount": 152900,
    "currency": "USD"
  },
  "account": {
    "id": "txn_8f2a1c9e",
    "name": "Camera",
    "code": "1200"
  },
  "tagIds": [
    "txn_8f2a1c9e"
  ],
  "tags": [
    {
      "id": "txn_8f2a1c9e"
    }
  ]
}

Changes

No recorded changes to this operation across all 4 revisions of this API.