Ga direct naar de documentatie
API

Een lid verwijderen

Beide assen tegelijk: de rol, en elke adrestoekenning die diegene hier heeft.

DELETEapi.openemail.uk/members/{userId}

Voert de echte aanroep uit op je workspace, met je eigen sleutel.

DELETE /members/{userId}

Beide assen tegelijk: de rol, en elke adrestoekenning die diegene hier heeft.

Voorbeeld

Vereist members:write.

curl
curl -X DELETE "$OE/members/7fQ2mN8vBz1aRd4tYwKx7fQ2mN8vBz1a" -H "$AUTH"
Respons
{  "object": "member",  "userId": "7fQ2mN8vBz1aRd4tYwKx7fQ2mN8vBz1a",  "deleted": true,  "addressesRevoked": 2}

Beide toekenningen gaan samen. Alleen de ledenrij verwijderen zou de slechtste van beide uitkomsten zijn: verdwenen uit deze lijst, en nog steeds de post lezen.

Het geeft GEEN 404 op iemand die geen lid is, en dat is geen slordigheid met id's. De groep die dit endpoint het hardst moet kunnen bereiken zijn de houders van oude toekenningen, die adrestoekenningen hebben en helemaal geen ledenrij, dus een voorafgaande controle op "bestaat er een ledenrij" zou precies de mensen weigeren wier toegang het meest ingetrokken moet worden. addressesRevoked is wat er werkelijk is gebeurd, en een nul daar is het eerlijke verslag van een no-op.

Het verwijdert diegene uit ÉÉN workspace. Het OpenEmail-account blijft onaangeroerd, net als elke toegang die diegene ergens anders heeft.

Om één adres terug te nemen en de persoon te laten staan, gebruik je in plaats daarvan DELETE /members/{userId}/addresses/{addressId}. Dat is de aanroep voor iemand die van team is gewisseld, niet voor iemand die is vertrokken.