Contents x
    Archive a estate agent
    • 04 Sep 2024
    • 1 Minute to read
    • Print
    • Dark
      Light
    Contents

    Archive a estate agent

    • Updated on 04 Sep 2024
    • 1 Minute to read
    • Print
    • Dark
      Light
    Article summary

    Post
    /api/v1/relations/estateAgents/archive

    Archives an existing estate agent from the given date. Either reference or externalIdentifier must have a value. If both are given, externalIdentifier will be used first for retrieving the estateAgent.

    Description

    Archives an existing Estate Agent from the given date. Either reference or externalIdentifier must have a value. Please note that if both identifiers are given, both must match; otherwise, an error message will be generated. It is recommended that the user utilizes only one identifier, with a preference for the reference. By using this operation the selected Owner will not be available anymore as an option to choose from lists. 

    Estate agents include a wide range of real estate brokerage services, including but not limited to real estate agents, brokers, and rental agents.

    Use Case

    The Bloxs user terminates the cooperation with an Estate Agent. Therefore the Estate Agent should not be shown in lists anymore. 

    FieldDescription
    referenceThe relationship number within Bloxs. This is unique (per client specific environment) for all relationships (EstateAgents, Organisations, Owners, Persons, Suppliers). 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.
    archiveDateThe date after which the organisation is archived.
    Security
    HTTP
    Type Bearer

    Please enter a valid token

    Query parameters
    reference
    string

    The internal identifier of the model (i.e. Reference, Code, Name, depends on model).

    externalIdentifier
    string

    The external API identifier of the model.

    archiveDate
    string (date-time)

    The date after which the estate agent is archived.

    Responses
    200

    The estate agent was archived

    object
    isArchived
    boolean
    archiveDate
    string (date-time) | null
    400

    The archiving 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 additionalProperties
    string
    404

    The requested estate agent was not found.

    What's Next