---
title: "Update a transaction"
method: PATCH
path: "/transact-workflow/v1/users/{userId}/transactions/{transactionId}"
tags: ["Transactions"]
---

# Update a transaction

`PATCH /transact-workflow/v1/users/{userId}/transactions/{transactionId}`

## Request

- Base URL: `https://api.lwolf.com`
- URL: `https://api.lwolf.com/transact-workflow/v1/users/{userId}/transactions/{transactionId}`
- Auth: HTTP bearer and API key in header `lw-subscription-key`

Applies a partial update to a transaction. Only the fields present in the body are modified.

## Path parameters

- `userId` string, uuid, required
- `transactionId` string, uuid, required

## Request body

- TransactionUpdate
  - `type` integer: Transaction type code. Observed value: `1`. **TODO: document the full list of code values and their meanings.**
  - `address1` string: Property street address, line 1.
  - `address2` string: Property street address, line 2.
  - `address3` string: Property street address, line 3 (e.g. unit number).
  - `address4` string: Property street address, line 4.
  - `locality` string: City / locality.
  - `region` string: State or province code.
  - `subRegion` string: County or sub-region.
  - `postalCode` string: Postal / ZIP code.
  - `country` string: Country.
  - `legalDescription` string: Legal description of the property.
  - `propertyIncludes` string: Items included with the property.
  - `propertyExcludes` string: Items excluded from the property.
  - `taxNumber` string: Property tax number.
  - `mlsNumber` string: MLS listing number.
  - `note` string: Free-form note.
  - `schoolDistrict` string: School district.
  - `zoningClass` string: Zoning classification.
  - `yearBuilt` integer: Year the property was built.
  - `phase` integer: Transaction phase code. Observed value: `1`. **TODO: document the full list of code values and their meanings.**
  - `propertyType` integer: Property type code. Observed value: `0`. **TODO: document the full list of code values and their meanings.**
  - `asking` number: Asking price.
  - `deposit` number: Deposit amount.
  - `taxes` number: Annual taxes.
  - `closingDate` string, date-time: Closing date.
  - `listingExpiration` string, date-time: Listing expiration date.
  - `listingGoesLive` string, date-time: Date the listing goes live.

## Response `200`

Successful response

## Other responses

- `400`: The request is malformed or contains invalid parameters.
- `401`: The access token is missing, invalid, or expired.
- `403`: The caller is not permitted to perform this operation.
- `404`: The requested resource does not exist.

---

[API](https://skmtc.dev/lwolf/apis/transact-api.md) · [All operations](https://skmtc.dev/lwolf/apis/transact-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lwolf/apis/transact-api/revisions/9688b0ba3cbc?raw)