Changes the acquisition's fields: a field you omit keeps its value, a field sent as `null` is cleared. A stage change is recorded in its history. A stale `If-Match` is `412`; without one the change applies to the acquisition as it is now.

​

Path Parameters

  • id
    Type: string
    required

    Acquisition id

Headers

  • If-Match
    Type: string

    The acquisition's etag; the change is refused when it has changed since

Body·

required

A partial change, sent with If-Match: a field you omit keeps its value, a field sent as null is cleared. responsibleUserId and stage cannot be cleared.

  • currentOwnerId
    Type: null | string

    The property's current owner, a contact or company id; null clears it

  • interest
    Type: enumnullable

    interested, maybe or not_interested; null clears it

    values
    interestedmaybenot_interested
  • Type: null | boolean

    false keeps the acquisition as your own and ends its link to the advisor's teaser; the link cannot be set again.

  • name
    Type: null | string

    Your own label; null clears it

  • propertyId
    Type: null | string

    The property pursued; null clears it

  • responsibleUserId
    Type: null | string

    The member responsible: a user id of your organisation

  • stage
    Type: enumnullable

    not_contacted, teaser, im, data_room or bid

    values
    not_contactedteaserimdata_roombid

Responses

  • application/json
  • application/problem+json
  • application/problem+json
  • application/problem+json
  • application/problem+json
  • application/problem+json
  • application/problem+json
  • application/problem+json
Request Example for patch/api/v1/acquisitions/{id}
curl 'https://app.propstreet.com/api/v1/acquisitions/{id}' \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "name": null,
  "propertyId": null,
  "currentOwnerId": null,
  "stage": "not_contacted",
  "interest": "interested",
  "responsibleUserId": null,
  "keepAdvisorLink": null
}'

{
  "id": "string",
  "uri": "string",
  "etag": "string",
  "name": null,
  "displayName": null,
  "stage": "not_contacted",
  "shownStage": "not_contacted",
  "interest": "interested",
  "outcome": "open",
  "closedUtc": null,
  "source": "own",
  "responsible": {
    "id": "string",
    "name": "string"
  },
  "propertyId": null,
  "property": {
    "locality": null,
    "category": null,
    "leasableAreaSqm": null,
    "latitude": null,
    "longitude": null
  },
  "currentOwner": {
    "type": "string",
    "id": "string",
    "name": null
  },
  "connection": {
    "state": "none",
    "inactiveReason": "declined",
    "advisorName": null
  },
  "origin": {
    "kind": "teaser",
    "title": "string",
    "locality": null,
    "categories": null
  },
  "nextTask": {
    "id": "string",
    "type": "call",
    "dueDateUtc": "2026-11-10T12:13:51.668Z",
    "assignee": {
      "id": "string",
      "name": "string"
    },
    "overdue": true
  },
  "createdUtc": "2026-11-10T12:13:51.668Z",
  "updatedUtc": "2026-11-10T12:13:51.668Z",
  "deletedUtc": null
}

OK

Previous
One acquisition, with its version in the `ETag` header.
Next
Closes the acquisition as won (bought), lost or parked. Won needs a property, makes it one of your own and, with `comp`, records the purchase as a comp: you as the buyer, the seller and — on an acquisition from an advisor's teaser whose advisor may be named — that advisor as the seller's advisor: once contact is established, the broker is added to your network under the advisor's company when not there yet. On an acquisition that follows an advisor's teaser, won closes the teaser too, lost closes it unless `closeTeaser` is false, parked leaves it. An acquisition bought before and reopened keeps its comp: closing it as won again with `comp` is `409` — edit that comp instead. A stale `If-Match` is `412`.
Propstreet Documentation