Contents x
    Delete a value for the object
    • 21 Feb 2025
    • 1 Minute to read
    • Print
    • Dark
      Light
    Contents

    Delete a value for the object

    • Updated on 21 Feb 2025
    • 1 Minute to read
    • Print
    • Dark
      Light
    Article summary

    Delete
    /api/v1/realestateobjects/propertyvaluations

    [PREVIEW] Delete a value for existing real estate object.

    Description

    Delete a value of an existing object. A real estate object can have several different types of values. Examples are the sales value or the rent value. 

    Both the 'reference' and the 'externalIdentifier' can be used to identify the object. Preferably only the reference is used. If this is not available, the externalIdentifier can be used. If both properties are used it is important that both are correct and match with the same entity (object). If this is not the case, the request will return with an error code.

    Use Case

    The rent value of 2024 will be increased with a certain percentage in 2025. The user wants to add a new value by utilizing the Valuation/POST endpoint. However, the user also wants to delete the old value. This operation can be used to achieve this.

    Request fields

    The request contains the following fields:

    FieldDescription
    referenceThe relationship number within Bloxs. This is unique (per client specific environment) for all objects. The relationship number is generated by the Bloxs system.
    externalIdentifierThe unique identifier within the system of the requesting party. This identifier is not generated by the Bloxs system.
    valueTypeNameThe value type. Examples are the sales value or the rent value.
    yearThe year in which the value has been assigned.


    Security
    HTTP
    Type Bearer

    Please enter a valid token

    Body parameters
    object
    reference
    string | null
    externalIdentifier
    string | null
    valueTypeName
    string Required
    Min length1
    Max length30
    year
    integer (int32) Required
    Minimum1900
    Maximum2100
    Responses
    200

    The value was removed

    boolean
    400

    The value has validation issues

    Expand All
    object
    type
    string | null
    title
    string | null
    traceId
    string | null
    status
    integer (int32)
    errors
    object | null
    property*
    Array of string | null additionalProperties
    string
    What's Next