# Updating pricelist data

{% hint style="info" %}
This is an experimental endpoint introduced in early 2026. We expect it to either expand and solidify, or be removed in the upcoming months.
{% endhint %}

## Request

Use **HTTP POST** and the endpoint `https://cms.realpad.eu/ws/v10/update-units`

Send the following required parameters as a **URL-encoded form**:

* `login` - string login obtained from our support.
* `password` - string password obtained from our support.
* `data` - stringified JSON object containing the instructions for updating the Units.

Sample cURL request:

```bash
curl -X POST \
	-F "login=..." \
	-F "password=..." \
	-F 'data={"units":[{"id":12345,"priceWithoutVat":10000,"priceWithVat":12000},{"id":9876,"priceWithoutVat":20000,"priceWithVat":24000}]}' \
	https://cms.realpad.eu/ws/v10/update-units
```

### JSON format

Only one top-level field `units` containing an array of JSON objects:

* `id` - Realpad DB ID of the Unit to update.
* `priceWithoutVat` - new price without VAT.
* `priceWithVat` - new price with VAT.

You only need to specify the exact Units you want to update. If you specify a Unit, all three fields are required.

```json
{                                                                                                                                                                                                                                 
    "units": [                                                                                                                                                                                                                      
      {                                                                                                                                                                                                                             
        "id": 12345,                                                                                                                                                                                                                
        "priceWithoutVat": 5000000,                                                                                                                                                                                                 
        "priceWithVat": 6050000                                                                                                                                                                                                     
      },                                                                                                                                                                                                                            
      {                                                                                                                                                                                                                             
        "id": 12346,                                                                                                                                                                                                                
        "priceWithoutVat": 4500000,                                                                                                                                                                                                 
        "priceWithVat": 5445000                                                                                                                                                                                                     
      }                                                                                                                                                                                                                             
    ]                                                                                                                                                                                                                               
}
```

The changes are applied atomically, ie. if one of the Units changes fails validation, the entire request is rejected.

## Response

HTTP codes handling the basic states:

* 5xx for a server error (possible to attempt an automatic retry a few times, provided there is a standoff).
* 4xx of authentication/permission error (reach out to our support team - no point in retrying).
* 2xx for a call that was evaluated on the business logic side.

The payload for HTTP 2xx is a JSON object with a description of how the changes were applied:

```json
{                                                                                                                                                                                                                                 
    "success": true,                                                                                                                                                                                                                
    "updatedCount": 2,                                                                                                                                                                                                              
    "units": [                                                                                                                                                                                                                      
      {"id": 12345, "success": true},                                                                                                                                                                                               
      {"id": 12346, "success": true}                                                                                                                                                                                                
    ]                                                                                                                                                                                                                               
}
```

In case of validation errors on the business logic side, the response will contain more detailed information:

```json
{                                                                                                                                                                                                                                 
    "success": false,                                                                                                                                                                                                               
    "error": "Validation failed for 2 unit(s)",                                                                                                                                                                                     
    "units": [                                                                                                                                                                                                                      
      {"id": 12345, "success": false, "error": "Unit is attached to a Deal"},                                                                                                                                                       
      {"id": 12346, "success": false, "error": "Batch rejected due to other validation errors"}                                                                                                                                     
    ]                                                                                                                                                                                                                               
}
```

{% hint style="info" %}
**See also:** [Authentication & Error Handling](/integrations/introduction/authentication-and-error-handling.md) for details on the banning behavior, `415 Unsupported Media Type`, and other shared error responses.
{% endhint %}

Reach out to our support team in case of trouble.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev.realpadsoftware.com/integrations/landing-page/updating-pricelist-data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
