Sign in
Listings

Update listing

Update listing-level fields (MLS/source/dates/price/property type metadata). listingDate, expirationDate, and listingPrice are required. If source is required for the subscriber, sourceId is required. When sourceId maps to Other Source, otherSource is required.

Validation & Requirements

Required Parameters

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

Required JSON Body Fields

  • sourceId (format=int32)
  • expirationDate (format=date-time, minLength=1)
  • listingPrice (format=decimal)

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.

Integration Requirement

  • Retrieve the corresponding ...Form endpoint immediately before write operations to get current dynamic required fields and allowed values.
put/api/files/listings/{listingGuid}

Path parameters

listingGuidstring guid required

GUID of the listing to update. Format: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

Request body

mlsNumberstring nullable
representationTypestring nullable

Optional representation type — which side the agent represents. Allowed values: Listing, Lease Landlord. Case-insensitive. Omitted or null leaves the stored value unchanged.

sourceIdinteger required
otherSourcestring nullable
listingDatestring date-time nullable
isOfficeLeadboolean nullable
expirationDatestring date-time required
listingPricenumber required
coListingAgentGuidstring guid nullable
fileIDstring nullable
realPropertySubtypeIdinteger nullable
realPropertyTypeIdinteger nullable

Response

valueUpdateListingResponse
warningsstring[] nullable

Changes

Changed in 1 of the 3 revisions of this API.1