Connections API

Onderhouden door: Aether365 Team Doelgroep: Ontwikkelaars Scope: Connection API endpoints - Microsoft 365 tenantkoppelingen beheren

Connections vertegenwoordigen gekoppelde Microsoft 365 tenants. Elke connection komt overeen met een Microsoft-tenant (geidentificeerd door het msTenantId) waarvoor admin consent is verleend.

Koppelingen ophalen

Retourneert alle Microsoft 365 tenants die zijn gekoppeld aan het geauthenticeerde account.

GET /tenants/me/connections

Voorbeeldverzoek

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

Voorbeeldresponse

{
  "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
    }
  ]
}

Responsevelden

Veld	Type	Beschrijving
id	string	Koppelingsidentificatie
msTenantId	string	Microsoft Entra tenant-ID (GUID)
label	string	Weergavelabel toegewezen bij het koppelen
connectedAt	string	ISO 8601-tijdstempel van het moment van koppeling
isPrimary	boolean	Of dit de momenteel actieve tenant is

---

Een koppeling activeren

Stelt een gekoppelde tenant in als de actieve tenant. Dashboardweergaven en API-aanroepen zonder expliciet tenantfilter werken op de actieve tenant.

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

Padparameters

Parameter	Type	Beschrijving
connectionId	string	Het koppeling-ID om te activeren

Voorbeeldverzoek

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

Voorbeeldresponse

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

---

Een koppeling verwijderen

Ontkoppelt een Microsoft 365 tenant. Stopt toekomstige scans voor deze tenant. Bestaande scangegevens worden bewaard volgens het retentiebeleid.

DELETE /tenants/me/connections/{connectionId}

WARNING

Deze actie kan niet ongedaan worden gemaakt. Het opnieuw koppelen van de tenant vereist het doorlopen van de admin consent-stroom.

Padparameters

Parameter	Type	Beschrijving
connectionId	string	Het koppeling-ID om te verwijderen

Voorbeeldverzoek

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

Voorbeeldresponse

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

Fouten

Code	HTTP	Beschrijving
CONNECTION_NOT_FOUND	404	Geen koppeling met dit ID bestaat voor deze tenant
CANNOT_REMOVE_LAST_CONNECTION	409	Kan de enige overgebleven koppeling niet verwijderen