Skip to content
HALOWERK

Datenwerk

ics merge

Parses all inputs with ical.js, keeps every VTIMEZONE once (first definition wins, conflicts are reported) and collects VEVENT, VTODO and VJOURNAL components. Components with the same UID and RECURRENCE-ID are reduced to the one with the highest SEQUENCE, then the latest LAST-MODIFIED/DTSTAMP. With dedupe=uid_and_content, events with different UIDs but the same normalised SUMMARY, start, end and RRULE are also merged (first one kept). Missing UIDs get a deterministic hash UID. Every removed.

POST https://daten.halowerk.com/v1/ics-merge

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
calendarsarrayYesiCalendar texts (RFC 5545), e.g. exported .ics files or CalDAV responses.
dedupestringNouid: only UID/RECURRENCE-ID duplicates; uid_and_content: also same title + start + end + RRULE.
timezonestringNoIANA zone used for floating times when comparing events.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "calendars"
  ],
  "properties": {
    "calendars": {
      "type": "array",
      "minItems": 2,
      "maxItems": 20,
      "description": "iCalendar texts (RFC 5545), e.g. exported .ics files or CalDAV responses.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "ics"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 80,
            "description": "Label used in the report."
          },
          "ics": {
            "type": "string",
            "minLength": 15,
            "maxLength": 1000000,
            "description": "Complete VCALENDAR text."
          }
        }
      }
    },
    "dedupe": {
      "type": "string",
      "enum": [
        "uid",
        "uid_and_content"
      ],
      "default": "uid_and_content",
      "description": "uid: only UID/RECURRENCE-ID duplicates; uid_and_content: also same title + start + end + RRULE."
    },
    "timezone": {
      "type": "string",
      "maxLength": 64,
      "default": "UTC",
      "description": "IANA zone used for floating times when comparing events."
    }
  }
}

Open original schema

Published input example

{
  "calendars": [
    {
      "name": "team",
      "ics": "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//HALOWERK//Stock review//DE\r\nBEGIN:VTIMEZONE\r\nTZID:Europe/Berlin\r\nBEGIN:DAYLIGHT\r\nTZOFFSETFROM:+0100\r\nTZOFFSETTO:+0200\r\nTZNAME:CEST\r\nDTSTART:19700329T020000\r\nRRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=-1SU\r\nEND:DAYLIGHT\r\nBEGIN:STANDARD\r\nTZOFFSETFROM:+0200\r\nTZOFFSETTO:+0100\r\nTZNAME:CET\r\nDTSTART:19701025T030000\r\nRRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU\r\nEND:STANDARD\r\nEND:VTIMEZONE\r\nBEGIN:VEVENT\r\nUID:api@halowerk.com\r\nDTSTAMP:20261001T000000Z\r\nDTSTART;TZID=Europe/Berlin:20261116T100000\r\nDTEND;TZID=Europe/Berlin:20261116T110000\r\nSUMMARY:Review\r\nEND:VEVENT\r\nEND:VCALENDAR"
    },
    {
      "name": "privat",
      "ics": "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//HALOWERK//Stock review//DE\r\nBEGIN:VEVENT\r\nUID:api@halowerk.com\r\nDTSTAMP:20261001T000000Z\r\nDTSTART;TZID=Europe/Berlin:20261116T130000\r\nDTEND;TZID=Europe/Berlin:20261116T143000\r\nSUMMARY:Workshop\r\nEND:VEVENT\r\nBEGIN:VEVENT\r\nUID:api@halowerk.com\r\nDTSTAMP:20261001T000000Z\r\nDTSTART;TZID=Europe/Berlin:20261116T150000\r\nDTEND;TZID=Europe/Berlin:20261116T160000\r\nTRANSP:TRANSPARENT\r\nSUMMARY:Focus (free)\r\nEND:VEVENT\r\nEND:VCALENDAR"
    }
  ],
  "dedupe": "uid_and_content"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’