Update bounded applicant, tenancy, billing and manual insurance-offer selection for one email-verified session using its exact current version and a durable idempotency key. Insurance choice is optional, never preselected or active cover; referral permission must be explicit. A household edit without a new insuranceSelection clears existing sharing permission and retains the package choice.
View input schema
{
"type": "object",
"properties": {
"expectedVersion": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"firstName": {
"type": "string",
"maxLength": 100
},
"lastName": {
"type": "string",
"maxLength": 100
},
"phone": {
"type": "string",
"maxLength": 100
},
"nationalityCode": {
"type": "string",
"maxLength": 10
},
"currentAddressLine1": {
"type": "string",
"maxLength": 200
},
"currentAddressLine2": {
"type": "string",
"maxLength": 200
},
"currentPostalCode": {
"type": "string",
"maxLength": 30
},
"currentCity": {
"type": "string",
"maxLength": 100
},
"currentCountryCode": {
"type": "string",
"maxLength": 10
},
"parkingInterest": {
"type": "boolean"
},
"adultCount": {
"anyOf": [
{
"type": "integer",
"minimum": 1,
"maximum": 10
},
{
"type": "null"
}
]
},
"preferredLanguage": {
"type": "string",
"enum": [
"de",
"en"
]
},
"desiredMoveInDate": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
]
},
"desiredMoveOutDate": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
]
},
"desiredDurationMonths": {
"anyOf": [
{
"type": "integer",
"minimum": 1,
"maximum": 120
},
{
"type": "null"
}
]
},
"requestedParkingCount": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 10
},
{
"type": "null"
}
]
},
"minorCount": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 20
},
{
"type": "null"
}
]
},
"petSummary": {
"type": "string",
"maxLength": 2000
},
"applicantMessage": {
"type": "string",
"maxLength": 10000
},
"employmentStatusSummary": {
"type": "string",
"maxLength": 2000
},
"employerOrCompanyName": {
"type": "string",
"maxLength": 500
},
"tenantProfiles": {
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"isMainTenant": {
"type": "boolean"
},
"firstName": {
"type": "string",
"maxLength": 100
},
"lastName": {
"type": "string",
"maxLength": 100
},
"birthDate": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
]
},
"identityDocumentType": {
"type": "string",
"enum": [
"PASSPORT",
"EU_ID"
]
},
"passportOrIdNumber": {
"type": "string",
"maxLength": 200
},
"phone": {
"type": "string",
"maxLength": 100
},
"email": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"maxLength": 320,
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
}
]
},
"nationalityCode": {
"type": "string",
"maxLength": 10
},
"permitStatus": {
"type": "string",
"enum": [
"SWISS_CITIZEN",
"EU_EFTA_CITIZEN",
"PERMIT_B",
"PERMIT_C",
"PERMIT_L",
"PERMIT_G",
"PERMIT_CI",
"PERMIT_F",
"PERMIT_N",
"PERMIT_S",
"NO_PERMIT_YET",
"OTHER"
]
},
"permitDetails": {
"type": "string",
"maxLength": 500
},
"addressSameAsMainTenant": {
"type": "boolean"
},
"addressLine1": {
"type": "string",
"maxLength": 200
},
"addressLine2": {
"type": "string",
"maxLength": 200
},
"postalCode": {
"type": "string",
"maxLength": 30
},
"city": {
"type": "string",
"maxLength": 100
},
"countryCode": {
"type": "string",
"maxLength": 10
},
"isBillingRecipient": {
"type": "boolean"
},
"isPrimaryTenancyContact": {
"type": "boolean"
}
},
"required": [
"id",
"isMainTenant",
"firstName",
"lastName",
"birthDate",
"identityDocumentType",
"passportOrIdNumber",
"phone",
"email",
"nationalityCode",
"permitStatus",
"permitDetails",
"addressSameAsMainTenant",
"addressLine1",
"addressLine2",
"postalCode",
"city",
"countryCode",
"isBillingRecipient",
"isPrimaryTenancyContact"
],
"additionalProperties": false
}
},
"tenantPartyMode": {
"type": "string",
"enum": [
"PRIVATE",
"COMPANY",
"COMPANY_WITH_PRIVATE_COTENANTS"
]
},
"companyTenantName": {
"type": "string",
"maxLength": 500
},
"companyTenantStreetLine1": {
"type": "string",
"maxLength": 200
},
"companyTenantStreetLine2": {
"type": "string",
"maxLength": 200
},
"companyTenantPostalCode": {
"type": "string",
"maxLength": 30
},
"companyTenantCity": {
"type": "string",
"maxLength": 100
},
"companyTenantCountryCode": {
"type": "string",
"maxLength": 10
},
"companyTenantSigners": {
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"firstName": {
"type": "string",
"maxLength": 100
},
"lastName": {
"type": "string",
"maxLength": 100
},
"roleTitle": {
"type": "string",
"maxLength": 100
},
"email": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"maxLength": 320,
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
}
]
},
"phone": {
"type": "string",
"maxLength": 100
}
},
"required": [
"id",
"firstName",
"lastName",
"roleTitle",
"email",
"phone"
],
"additionalProperties": false
}
},
"billingIntentType": {
"type": "string",
"enum": [
"TENANT",
"COMPANY",
"OTHER_PRIVATE"
]
},
"billingEmail": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"maxLength": 320,
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
}
]
},
"billingPrivateFirstName": {
"type": "string",
"maxLength": 100
},
"billingPrivateLastName": {
"type": "string",
"maxLength": 100
},
"companyBillingName": {
"type": "string",
"maxLength": 500
},
"billingStreetLine1": {
"type": "string",
"maxLength": 200
},
"billingStreetLine2": {
"type": "string",
"maxLength": 200
},
"billingPostalCode": {
"type": "string",
"maxLength": 30
},
"billingCity": {
"type": "string",
"maxLength": 100
},
"billingCountryCode": {
"type": "string",
"maxLength": 10
},
"insuranceSelection": {
"anyOf": [
{
"type": "object",
"properties": {
"version": {
"type": "number",
"const": 1
},
"catalogueVersion": {
"type": "string",
"const": "elron-liability-2026-10-30"
},
"choice": {
"type": "string",
"enum": [
"SINGLE",
"TWO_ADULTS",
"FAMILY",
"INDIVIDUAL",
"OWN"
],
"description": "SINGLE — Single person — For one adult. — CHF 295 per year — Cover limits: contents up to CHF 20'000 · Personal liability up to CHF 10 million · Worldwide theft up to CHF 2'000 · Electronics damage up to CHF 2'000 — Annual payment. The separate offer and insurance terms govern the cover.; TWO_ADULTS — Two adults — For two adults without children. — CHF 390 per year — Cover limits: contents up to CHF 30'000 · Personal liability up to CHF 10 million · Worldwide theft up to CHF 2'000 · Electronics damage up to CHF 2'000 — Annual payment. The separate offer and insurance terms govern the cover.; FAMILY — Family — For families with one to four children. — CHF 400 per year — Cover limits: contents up to CHF 40'000 · Personal liability up to CHF 10 million · Worldwide theft up to CHF 2'000 · Electronics damage up to CHF 2'000 — Annual payment. The separate offer and insurance terms govern the cover.; INDIVIDUAL — Individual offer — If none of these packages suits your household.; OWN — I’ll arrange my own liability insurance"
},
"referralConsent": {
"type": "boolean",
"description": "Explicit resident permission to share insured persons’ names, birth dates and nationalities, adults’ email addresses and mobile numbers, apartment address, floor, room count, rental start, selected offer, document language and contract reference with jan.koch@axa.ch, copying alex.roschi@elronversicherungen.ch. Referral follows full rental signature and accepted signed-copy delivery. Without permission it stays unsent for follow-up. This does not activate cover."
},
"documentLanguage": {
"type": "string",
"enum": [
"DE",
"EN",
"FR",
"IT"
],
"description": "Requested language for the tenant’s separate insurance offer and policy documents (DE, EN, FR or IT). New referral emails to Jan Koch are written in German, independently of this document-language choice."
},
"children": {
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"firstName": {
"type": "string",
"maxLength": 100
},
"lastName": {
"type": "string",
"maxLength": 100
},
"birthDate": {
"type": "string",
"maxLength": 10
},
"nationalityCode": {
"type": "string",
"maxLength": 2
}
},
"required": [
"firstName",
"lastName",
"birthDate",
"nationalityCode"
],
"additionalProperties": false
}
}
},
"required": [
"version",
"choice",
"referralConsent"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"contractLanguageCode": {
"type": "string",
"enum": [
"DE",
"EN"
]
},
"sessionToken": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"expectedVersion",
"sessionToken",
"idempotencyKey"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}