Listings

Update Listing Fields

PATCHhttps://api.getcovent.com/api/v1/listings/{id}

Update listing fields such as status, pricing, or property details.

How to Call

Use one of the examples below to call this endpoint from your own integration.

curl -X PATCH "https://api.getcovent.com/api/v1/listings/{id}" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "active",
  "pricing": {
    "asking_price": 395000,
    "assignment_fee": 18000
  }
}'

Request

Review headers, parameters, and body fields before calling this endpoint.

AuthorizationstringRequired

Bearer token for the proposed external API contract.

Example: Bearer <API_KEY>
AcceptstringRequired

Response format header.

Example: application/json
Content-TypestringRequired

JSON request body header.

Example: application/json

idstringRequired

id path parameter.

Example: <id>

statusstringRequired

status request field.

Example: active
pricingobjectRequired

pricing request field.

Example: {"asking_price":395000,"assignment_fee":18000}

Response

200application/json

idstringRequired

id response field.

Example: lst_123
headlinestringRequired

headline response field.

Example: Off-market duplex in central Phoenix
statusstringRequired

status response field.

Example: active
pricingobjectRequired

pricing response field.

Example: {"asking_price":395000,"assignment_fee":18000}
updated_atstringRequired

updated_at response field.

Example: 2026-04-17T20:15:00Z

Response Example

{
  "id": "lst_123",
  "headline": "Off-market duplex in central Phoenix",
  "status": "active",
  "pricing": {
    "asking_price": 395000,
    "assignment_fee": 18000
  },
  "updated_at": "2026-04-17T20:15:00Z"
}