V2 Sales

Update sale (V2)

Changed on

Updates sale-level fields for the specified sale, using V2 managed fields.

Validation & Requirements

Required Parameters

  • saleGuid (path, string, format=guid)
  • form (body, object)

Required JSON Body Fields

  • None

Validations

  • Invalid GUID values in *Guid/*Guids fields return 422 Unprocessable Entity.
  • Invalid date values in *date* fields return 422 Unprocessable Entity.
  • Missing required request body returns 422 Unprocessable Entity with Missing request body..
  • Additional business-rule validation may return 422 with details in the errors array.
put/api/v2/files/sales/{saleGuid}

Request

  • Base URL
    https://api.skyslope.com
  • URL
    https://api.skyslope.com/api/v2/files/sales/{saleGuid}
  • Auth
    OpenID Connect (https://example.com/.well-known/openid-configuration)

Path parameters

saleGuidstring guid required

GUID of the sale to update.

Request body

mlsNumberstring nullable
dealTypestring nullable

Optional representation type — which side the agent represents. Allowed values: Purchase, Listing, Both Purchase & Listing, Lease Tenant, Lease Landlord, Both Lease Tenant & Landlord, Referral, BPO, Other. Case-insensitive. Omitted or null leaves the stored value unchanged.

contractAcceptanceDatestring date-time nullable
escrowNumberstring nullable
escrowClosingDatestring date-time nullable
actualClosingDatestring date-time nullable

Setting this field closes the sale (status → Closed) and records the closing date. Prefer the dedicated PUT /api/files/sales/{saleGuid}/close endpoint for an explicit close action.

sourceIdinteger nullable

SourceId can be retrieved from the AllowableSelections list.

otherSourcestring nullable

Required only for certain SourceId fields

listingPricenumber nullable
salePricenumber nullable
isOfficeLeadboolean nullable
fileIdstring nullable
apnstring nullable
realPropertyTypeIdinteger nullable
realPropertySubtypeIdinteger nullable

Response

valueUpdateSaleResponse
warningsstring[] nullable

Changes