Connections API

Betreut von: Aether365 Team Zielgruppe: Entwickler Umfang: Connection API-Endpunkte - Verwaltung von Microsoft 365 Tenant-Verbindungen

Connections repräsentieren verknüpfte Microsoft 365 Tenants. Jede Connection entspricht einem Microsoft-Tenant (identifiziert durch seine msTenantId), dem Admin Consent erteilt wurde.

Connections auflisten

Gibt alle mit dem authentifizierten Konto verbundenen Microsoft 365 Tenants zurück.

GET /tenants/me/connections

Beispielanfrage

curl https://api.aether365.io/tenants/me/connections \
  -H "Authorization: Bearer <token>"

Beispielantwort

{
  "success": true,
  "data": [
    {
      "id": "conn_abc123",
      "msTenantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "label": "Contoso Production",
      "connectedAt": "2026-02-01T09:00:00Z",
      "isPrimary": true
    },
    {
      "id": "conn_def456",
      "msTenantId": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
      "label": "Contoso Staging",
      "connectedAt": "2026-03-15T14:30:00Z",
      "isPrimary": false
    }
  ]
}

Antwortfelder

Feld	Typ	Beschreibung
id	string	Verbindungskennung
msTenantId	string	Microsoft Entra Tenant-ID (GUID)
label	string	Bei der Verbindung zugewiesenes Anzeigelabel
connectedAt	string	ISO 8601-Zeitstempel der Tenant-Verbindung
isPrimary	boolean	Ob dies der aktuell aktive Tenant ist

---

Eine Connection aktivieren

Setzt einen verbundenen Tenant als aktiven Tenant. Dashboard-Ansichten und API-Aufrufe ohne expliziten Tenant-Filter arbeiten mit dem aktiven Tenant.

POST /tenants/me/connections/{connectionId}/activate

Pfadparameter

Parameter	Typ	Beschreibung
connectionId	string	Die zu aktivierende Verbindungs-ID

Beispielanfrage

curl -X POST https://api.aether365.io/tenants/me/connections/conn_def456/activate \
  -H "Authorization: Bearer <token>"

Beispielantwort

{
  "success": true,
  "data": {
    "id": "conn_def456",
    "msTenantId": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
    "label": "Contoso Staging",
    "connectedAt": "2026-03-15T14:30:00Z",
    "isPrimary": true
  }
}

---

Eine Connection entfernen

Trennt einen Microsoft 365 Tenant. Stoppt zukünftige Scans für diesen Tenant. Vorhandene Scandaten werden gemäß der Aufbewahrungsrichtlinie beibehalten.

DELETE /tenants/me/connections/{connectionId}

WARNING

Diese Aktion kann nicht rückgängig gemacht werden. Eine erneute Verbindung des Tenants erfordert ein erneutes Durchlaufen des Admin-Consent-Ablaufs.

Pfadparameter

Parameter	Typ	Beschreibung
connectionId	string	Die zu entfernende Verbindungs-ID

Beispielanfrage

curl -X DELETE https://api.aether365.io/tenants/me/connections/conn_def456 \
  -H "Authorization: Bearer <token>"

Beispielantwort

{
  "success": true,
  "data": null
}

Fehler

Code	HTTP	Beschreibung
CONNECTION_NOT_FOUND	404	Keine Verbindung mit dieser ID für diesen Tenant vorhanden
CANNOT_REMOVE_LAST_CONNECTION	409	Die einzige verbleibende Verbindung kann nicht entfernt werden