• API Docs
  • Guide for real estate
  • Sync listings
Last update 07/06/2022

Update your listings

Once you have active listings on our site, you’ll probably need to update and modify those listings from time to time. Follow this guide to know how to achieve this actions.


You can modify the values for:
  • Title
  • Price
  • Phone Number
  • Pictures
  • Description*
  • Location
  • Attributes (array “attributes”)
*It's not possible modify, just add a post. Also remember that:
  • Category can’t be modified via API.
  • Listing type can be modified only once.

Update your item

Let’s see a basic example of updating an item title and price. The only thing you need is the item_id of the listed product and of course, the seller’s access_token. Example:
 curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
  "title": "Your new title",
  "price": 1000
Nice, your item title and price has been updated and you should receive a code 200 OK response status to know everything went well. Keep in mind that it can take some time until you see the item’s information refreshed.


It’s very easy to update a description, and is something you can do whether the item has bids or not, but since there are some considerations you need to keep when adding or replacing descriptions, check our descriptions article to make sure you get it right.


You can always add or replace item pictures, refer to our working with pictures tutorial to know the best way to get through it.

Listing types

When you want more exposition on your item you need to make a listing type upgrade. Know the details and considerations and learn how to achieve an upgrade on our Listing types and Upgrades tutorial.

Changing listing status

Any item listed on our marketplace can hold different status, check the following description of each one: closed: Finalizes your publication. Once closed, it cannot be reactivated again, but it can be relisted.
  • paused: Pauses your publication. Once paused, the contact data will no longer be visible.
  • active: Reactivates a previously paused item.
  • If you need to make any changes on the item status, you need to send any of these values for the “status” field, note the value is case sensitive and must be sent in lowercase. Follow the example to pause an active item: Example:
    curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
    Excellent! Your item has been paused. Now you can try to activate it again by making the exact same call sending “active” instead of “paused” as the status value. If your item is currently closed and your intention is to relist it, check our relist article to achieve it right away. Please check out the listing life-cycle article to know more about item status.

    Delete listing

    Deleting a listing has no way back, so be careful when you call this action. Also note that there’s no need to delete closed items since they’ll be discarded automatically after some time. Example: First step
    curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
    "status": "closed"
    Second step
    curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
    • - If with the second PUT you get an error:
    • message: item optimistic locking error: conflict status: 409 cause: array(0) This means you should wait a few seconds until the information is updated.
    • Once the listing is removed, it will remain in the VIP for a short time as "listing finished.".
    That’s it! Your item should be removed. Next topic: Manage contacts & visits.
    banner footer

    Subscribe to our Newletter

    or register to recieve the latest news about our API