Record an absence
absence_createRecords a flat member's absence for a date range, such as a holiday, so others can see when they are away.
Instructions
Record that a flat member is away for a date range, for example a holiday. Use it for a person being away; use event_create for a calendar entry that concerns the whole flat. Members can record their own absence; recording one for another member needs a flat admin, otherwise 403 not_owner. The memberId must belong to an active member of this flat. An endDate before startDate fails with date_range_invalid. An absence that overlaps another absence of the same member (by Berlin calendar day) fails with 409 absence_overlaps_existing. Returns the created absence with its id.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"memberId": "<memberId>",
"startDate": "<startDate>",
"endDate": "<endDate>"
},
"name": "absence_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | No | Optional free-text reason, for example "Holiday". Omit or send null for none. | |
| wgCode | No | Share code of the flat (code from wg_list). Leave it out when the account belongs to one flat. | |
| endDate | Yes | Last day of the absence, inclusive, as ISO 8601 datetime with offset, not before startDate. Only the Berlin calendar day counts. | |
| memberId | Yes | Id of the absent member, from members_list or wg_overview. Use your own member id unless you are a flat admin. | |
| startDate | Yes | First day of the absence as ISO 8601 datetime with offset, for example 2026-12-24T00:00:00+01:00. Only the Berlin calendar day counts. |