# diagnose_sync

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

Source: https://docs.getridian.com/de/developers/tools/diagnose_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

Erklärt, warum ein Synchronisierungspaar des Nutzers nicht läuft, anhand des gespeicherten Zustands und Grundes, und benennt die beteiligten Kalender, soweit die erteilte Auswahl sie abdeckt. Die Gründe sind eine geschlossene Aufzählung; ein unbekannter wird als `other` gemeldet statt geraten, und dann wird auch kein nächster Schritt behauptet. Nennt keine Ursachen auf Terminebene. Konto neu verbinden, die Tarifdetails des Workspace ansehen oder das Ziel eines bestehenden Paars ändern passiert in der Ridian-App; nextStepUrl verlinkt die Seite für den gespeicherten nächsten Schritt.

## Berechtigungen

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

`sync:read`

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

## Eingabe

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    }
  },
  "required": [
    "ref"
  ],
  "additionalProperties": false
}
```

## Ausgabe

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "syncs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ref": {
            "type": "string"
          },
          "source": {
            "type": "object",
            "properties": {
              "id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "name"
            ],
            "additionalProperties": false
          },
          "target": {
            "type": "object",
            "properties": {
              "id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "name"
            ],
            "additionalProperties": false
          },
          "twoWay": {
            "type": "boolean"
          },
          "status": {
            "type": "string",
            "enum": [
              "active",
              "paused",
              "error",
              "deleting"
            ]
          },
          "reason": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "userPaused",
                  "sourceUnavailable",
                  "targetUnavailable",
                  "targetReadOnly",
                  "unsupportedProvider",
                  "planLimit",
                  "other"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "nextStep": {
            "type": [
              "string",
              "null"
            ]
          },
          "nextStepUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "unavailableSince": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "ref",
          "source",
          "target",
          "twoWay",
          "status",
          "reason",
          "nextStep",
          "nextStepUrl",
          "unavailableSince"
        ],
        "additionalProperties": false
      }
    },
    "scope": {
      "type": "string",
      "const": "own_pairs_in_this_workspace"
    }
  },
  "required": [
    "syncs",
    "scope"
  ],
  "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/)