API připojení

Připojení představují propojené Microsoft 365 tenanty. Každé připojení odpovídá Microsoft tenantu (identifikovanému jeho msTenantId), kterému byl udělen souhlas správce.

Seznam připojení

Vrací všechny Microsoft 365 tenanty připojené k autentizovanému účtu.

GET /tenants/me/connections

Příklad požadavku

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

Příklad odpovědi

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

Pole odpovědi

Pole	Typ	Popis
id	string	Identifikátor připojení
msTenantId	string	ID Microsoft Entra tenanta (GUID)
label	string	Zobrazovaný název přiřazený při připojení
connectedAt	string	Časové razítko ISO 8601 připojení tenanta
isPrimary	boolean	Zda se jedná o aktuálně aktivního tenanta

---

Aktivace připojení

Nastaví připojeného tenanta jako aktivního. Zobrazení v dashboard a API volání bez explicitního filtru tenanta pracují s aktivním tenantem.

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

Parametry cesty

Parametr	Typ	Popis
connectionId	string	ID připojení, které chcete aktivovat

Příklad požadavku

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

Příklad odpovědi

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

---

Odebrání připojení

Odpojí Microsoft 365 tenanta. Zastaví budoucí skeny pro tohoto tenanta. Existující data skenů jsou uchovávána podle zásad uchovávání.

DELETE /tenants/me/connections/{connectionId}

WARNING

Tuto akci nelze vrátit zpět. Opětovné připojení tenanta vyžaduje opakování toku souhlasu správce.

Parametry cesty

Parametr	Typ	Popis
connectionId	string	ID připojení, které chcete odebrat

Příklad požadavku

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

Příklad odpovědi

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

Chyby

Kód	HTTP	Popis
CONNECTION_NOT_FOUND	404	Pro tohoto tenanta neexistuje připojení s tímto ID
CANNOT_REMOVE_LAST_CONNECTION	409	Nelze odebrat jediné zbývající připojení