Archive a person

Prev Next
Post
/api/v1/relations/persons/archive

Archives an existing person from the given date. Either reference or externalIdentifier must have a value. If both are given, both are used for retrieving the person.

Description

Archives an existing person 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 person will not be available anymore as an option to choose from lists.

A person is a standalone entity and pertains to an enhancement of organisation. This could be a contact person within an organisation. Several users utilize this to enter their own employees into the system.

Use Case

The Bloxs user terminates the cooperation with a person. Therefore the person 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 person is archived.
Security
HTTP
Type Bearer

Please enter a valid token

Query parameters
archiveDate
string (date) Required

The date on which it is archived.

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.

Responses
200

The person was archived

Expand All
object
languageISOCode
string | null
Min length0
Max length2
address
object (Address)
street
string
Min length0
Max length200
houseNumber
string | null
Min length0
Max length40
postalCode
string
Min length0
Max length20
city
string
Min length0
Max length200
countryISOCode
string
Min length0
Max length2
invoiceAddress
object (Address)
street
string
Min length0
Max length200
houseNumber
string | null
Min length0
Max length40
postalCode
string
Min length0
Max length20
city
string
Min length0
Max length200
countryISOCode
string
Min length0
Max length2
postalAddress
object (Address)
street
string
Min length0
Max length200
houseNumber
string | null
Min length0
Max length40
postalCode
string
Min length0
Max length20
city
string
Min length0
Max length200
countryISOCode
string
Min length0
Max length2
primaryEmailAddresses
Array of string | null
string
invoicesEmailAddresses
Array of string | null
string
paymentRemindersEmailAddresses
Array of string | null
string
indexationsEmailAddresses
Array of string | null
string
serviceTicketsEmailAddresses
Array of string | null
string
purchaseOrdersEmailAddresses
Array of string | null
string
portalsEmailAddresses
Array of string | null
string
otherEmailAddresses
Array of string | null
string
externalIdentifier
string | null
Min length0
Max length100
phoneNumber
string | null
mobileNumber
string | null
cocNumber
string | null
Min length0
Max length256
cocDescription
string | null
vatNumber
string | null
Min length0
Max length256
correspondenceMethod
integer (int32)
Valid values[ 1, 2 ]
remarks
string | null
relationTypeName
string
Min length0
Max length256
communicationFormName
string
Min length0
Max length256
initials
string | null
Min length0
Max length20
firstName
string | null
Min length0
Max length200
lastName
string
Min length0
Max length200
lastNamePrefix
string | null
Min length0
Max length112
dateOfBirth
string (date) | null
jobTitle
string | null
Min length0
Max length256
identificationTypes
Array of object (IdentificationType) | null
object
identificationTypeItemName
string
Min length0
Max length256
identificationNumber
string
Min length0
Max length100
reference
string | null
Min length0
Max length100
displayName
string | null
archiveDate
string (date) | 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 | null additionalProperties
string
404

The requested person was not found.