# create_sync

Verhalten, Eingaben, Ausgaben und Freigaben für create_sync.

Source: https://docs.getridian.com/de/developers/tools/create_sync/
Language: de
Reviewed: 2026-10-06

Diese Referenz wird aus dem veröffentlichten Werkzeugvertrag erzeugt. Feldnamen und normative Beschreibungen im Schema sind Englisch.

## Verhalten und Grenzen

Legt eine einseitige Synchronisierung von einem Kalender des Nutzers in einen anderen an, nachdem der Nutzer genau diese Quelle, dieses Ziel und diesen Detailgrad im Chat bestätigt hat. Zuerst preview_sync aufrufen und dem Nutzer sagen, was dabei herauskommt. Dieselben Prüfungen laufen hier erneut, eine Vorschau garantiert also nichts. Eine stabile `requestId` mitgeben: derselbe Wert mit denselben Angaben liefert dieselbe Synchronisierung statt einer zweiten, derselbe Wert mit anderen Angaben scheitert. Das Ergebnis ist `created_pending_processing`: Das Paar besteht und die Engine beginnt zu kopieren; synchronisiert ist noch nichts. Regeln ändern, Richtung umkehren oder eine Synchronisierung löschen geht hier nicht — das passiert in der Ridian-App, verlinkt als syncsUrl. Eine so angelegte Synchronisierung läuft als eigener Ridian-Auftrag weiter, auch nachdem der Zugriff dieses Assistenten widerrufen wurde. Der fortlaufende Auftrag ändert und entfernt seine verwalteten Zielkopien, wenn die zugehörigen Quelltermine geändert oder gelöscht werden.

## Berechtigungen

Freigegebene Scopes, Konten, Kalender und Sichtbarkeitsregeln begrenzen den Zugriff. Ein Workspace-Admin erhält dadurch keinen pauschalen Zugriff auf fremde Konten.

`sync:read`, `sync:write`

[Freigaben und Grenzen](https://docs.getridian.com/de/developers/authentication/)

## Eingabe

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "sourceCalendarId": {
      "type": "string",
      "minLength": 1
    },
    "targetCalendarId": {
      "type": "string",
      "minLength": 1
    },
    "detailLevel": {
      "type": "string",
      "enum": [
        "busy_only",
        "title_and_time",
        "full_details"
      ],
      "description": "How much of each event reaches the target calendar. Ask the user; do not assume."
    },
    "requestId": {
      "type": "string",
      "minLength": 8,
      "maxLength": 100
    }
  },
  "required": [
    "sourceCalendarId",
    "targetCalendarId",
    "detailLevel",
    "requestId"
  ],
  "additionalProperties": false
}
```

## Ausgabe

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "const": true
    },
    "status": {
      "type": "string",
      "const": "created_pending_processing"
    },
    "legs": {
      "type": "number"
    },
    "replayed": {
      "type": "boolean"
    },
    "syncsUrl": {
      "type": "string"
    }
  },
  "required": [
    "ok",
    "status",
    "legs",
    "replayed",
    "syncsUrl"
  ],
  "additionalProperties": false
}
```

## Fehler und Wiederholungen

Prüfe das Werkzeugergebnis auf Fehler. Wiederhole Schreiboperationen nicht blind nach einem Timeout. Prüfe zuerst den aktuellen Ressourcen- oder Sendestatus.

[Fehlerbehandlung](https://docs.getridian.com/de/developers/errors/)