# listings_update

> Update an existing listing's information or status.

<!-- Source: https://docs.actuallycare.com/tools/listings/listings_update -->

Update an existing listing's information or status. Only provided fields are updated — omitted fields remain unchanged. Common uses: price reduction (update list_price), status change (active→pending→sold), address correction, extend expiration date. Status transitions: active → pending (offer accepted) → sold (closed) or expired/cancelled (listing ended). Returns the updated listing record. If the listing_id is not found, the error suggests using [`listings_list`](/tools/listings/listings_list).

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `listing_id` | string | Yes | UUID of the listing to update (required). Use [`listings_list`](/tools/listings/listings_list) to find the ID if unknown. · Format: UUID |
| `property_address` | string | No | Updated street address. |
| `display_address` | string | No | Updated display address (e.g., with unit number). |
| `city` | string | No | Updated city name. |
| `state` | string | No | Updated state abbreviation. |
| `zip_code` | string | No | Updated ZIP code. |
| `county` | string | No | Updated county name. |
| `latitude` | number | No | Updated latitude coordinate. |
| `longitude` | number | No | Updated longitude coordinate. |
| `list_price` | number | No | Updated listing price (price reduction or increase). · Min: 0 |
| `mls_number` | string | No | Updated MLS listing number. |
| `bedrooms` | number | No | Updated bedroom count. · Min: 0 |
| `bathrooms` | number | No | Updated bathroom count (can be decimal for half baths). · Min: 0 |
| `square_feet` | number | No | Updated square footage. · Min: 0 |
| `property_type` | enum | No | Updated property type (rare — usually fixed at creation). · One of: `single_family`, `condo`, `townhouse`, `multi_family`, `land`, `commercial` |
| `close_price` | number | No | Close/sale price (RESO ClosePrice). |
| `close_date` | string | No | Close date (ISO 8601, RESO CloseDate). |
| `listing_date` | string | No | Updated date listing went active on MLS. (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
| `expiration_date` | string | No | Updated expiration date (for extensions). (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
| `listing_status` | enum | No | Updated status. active→pending→sold is the typical flow. · One of: `active`, `pending`, `sold`, `expired`, `cancelled` |
| `description` | string | No | Updated description. |
| `public_remarks` | string | No | RESO PublicRemarks. |
| `private_remarks` | string | No | RESO PrivateRemarks (agent-only notes). |
| `buyer_agent_mls_id` | string | No | RESO BuyerAgentMlsId. |
| `buyer_agent_full_name` | string | No | RESO BuyerAgentFullName. |

## Example prompts

- "Drop the price on 412 Birchwood Ln to 475,000."
- "Mark the Marsh Creek condo pending, we accepted an offer this morning."

## Safety

**Updates data.** Changes an existing record. The change is visible immediately in the app and can be edited back.

## Previous name

This tool was previously published as `update_listing`. Call it by its current name — legacy names are kept here for reference and old links redirect, but they are not callable.