---
title: "Update listing"
method: PUT
path: "/api/files/listings/{listingGuid}"
tags: ["Listings"]
---

# Update listing

`PUT /api/files/listings/{listingGuid}`

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.

## Path parameters

- `listingGuid` string, guid, required

## Request body

- UpdateListingsForm
  - `mlsNumber` string, nullable
  - `sourceId` integer, required
  - `otherSource` string, nullable
  - `listingDate` string, date-time, nullable
  - `isOfficeLead` boolean, nullable
  - `expirationDate` string, date-time, required
  - `listingPrice` number, required
  - `coListingAgentGuid` string, guid, nullable
  - `fileID` string, nullable
  - `realPropertySubtypeId` integer, nullable
  - `realPropertyTypeId` integer, nullable
  - `commercialLease` CommercialLeaseDTO2
    - `size` number, nullable
    - `sizeType` string, nullable

## Response `200`

- LinkedResponseOfUpdateListingResponse
  - `value` UpdateListingResponse
  - `warnings` string[], nullable
  - `links` Link[], nullable
    - `href` string, nullable
    - `rel` string, nullable
    - `method` string, nullable

## Other responses

- `404`
- `422`

---

[API](https://skmtc.net/skyslope/apis/skyslope-api.md) · [All operations](https://skmtc.net/skyslope/apis/skyslope-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skyslope/skyslope-api/revisions/bad0d2db9b7a/schema)