Drive voor een mailbox uitschakelen via API

Opslag wordt binnen je hele account gedeeld. Als één persoon Drive als persoonlijke cloudopslag gebruikt, verbruikt die dus de ruimte die alle anderen voor e-mail nodig hebben. Elke mailbox heeft een drive_access-niveau dat bepaalt tot welk deel van Drive de gebruiker toegang heeft. Deze pagina is de naslag voor het instellen daarvan.

Dezelfde instelling vind je in het dashboard onder Mailboxen → (een mailbox) → Limieten. Ze is beschikbaar bij elk abonnement en kost niets extra.

De drie niveaus

full is de standaardwaarde en geldt voor elke bestaande mailbox. Ontvangst wordt nooit beïnvloed: een grote bijlage die iemand naar de mailbox stuurt, wordt op elk niveau zoals altijd vanuit webmail geopend.

Vereiste scope

mailboxes:write, dezelfde scope waarmee elk ander mailboxveld wordt bijgewerkt. Beide endpoints hieronder accepteren een Idempotency-Key-header en kunnen veilig opnieuw worden uitgevoerd.

Eén mailbox

curl -s -X PATCH "https://trekmail.net/api/v1/mailboxes/{MAILBOX_ID}" \
  -H "Authorization: Bearer tm_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: drive-access-{MAILBOX_ID}-off" \
  -d '{"drive_access":"disabled"}'

De bijgewerkte mailbox wordt met het nieuwe niveau geretourneerd:

{ "data": { "id": 1701, "email": "sam@example.com", "drive_access": "disabled", "...": "..." } }

drive_access wordt ook geretourneerd door GET /api/v1/mailboxes/{id} en door het lijstendpoint. Je kunt dus controleren wat is ingesteld zonder iets te wijzigen.

Meerdere mailboxen tegelijk

curl -s -X POST "https://trekmail.net/api/v1/mailboxes:drive-access" \
  -H "Authorization: Bearer tm_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: drive-access-domain-123-off" \
  -d '{"domain_id":123,"drive_access":"disabled"}'

Geef precies één selector door:

Het antwoord laat zien wat er is gebeurd:

{ "data": { "drive_access": "disabled", "matched": 24, "updated": 21, "skipped_shared": 3 } }

matched is het aantal mailboxen dat de selector heeft gevonden en updated het aantal dat daadwerkelijk is gewijzigd. Mailboxen die al het gevraagde niveau hebben, tellen wel als gevonden maar worden niet bijgewerkt. De aanroep opnieuw uitvoeren kan dus geen kwaad. Dit is handig wanneer je volgens een schema een standaardwaarde op nieuwe mailboxen toepast.

Op nieuwe mailboxen toepassen

Bij het maken van een mailbox kun je drive_access niet opgeven; nieuwe mailboxen beginnen met full. Wil je een mailbox inrichten die nooit Drive-toegang heeft gehad, maak deze dan aan en stel daarna het niveau in:

# 1. Create the mailbox. The server generates the one-time password and returns it once.
curl -s -X POST "https://trekmail.net/api/v1/mailboxes" \
  -H "Authorization: Bearer tm_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: create-mailbox-sam" \
  -d '{"domain_id":123,"local_part":"sam","password_mode":"generated_one_time"}'

# 2. Turn off Drive using the id returned above.
curl -s -X PATCH "https://trekmail.net/api/v1/mailboxes/1701" \
  -H "Authorization: Bearer tm_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: drive-access-1701-off" \
  -d '{"drive_access":"disabled"}'

Als je mailboxen in batches maakt, is het eenvoudiger om ze allemaal te maken en daarna één bulkaanroep met domain_id uit te voeren.

Met een MCP-agent

set_mailboxes_drive_access(domain_id=123, drive_access="disabled")

De tool accepteert dezelfde drie selectors als het REST-endpoint en retourneert dezelfde aantallen. Voor één mailbox werkt update_mailbox(mailbox_id=1701, drive_access="disabled") ook.

Gedeelde mailboxen

Het afzonderlijke endpoint weigert gedeelde mailboxen met 422 drive_access_not_applicable. Het bulkendpoint slaat ze over, maar telt ze wel mee. Niemand meldt zich rechtstreeks bij een gedeelde mailbox aan: je team opent deze vanuit de eigen mailbox, zodat het niveau van de mailbox van dat lid geldt. Iemand voor wie je Drive hebt uitgeschakeld, kan niet bij de bestanden van een gedeelde mailbox en kan zo’n mailbox ook niet gebruiken om de instelling te omzeilen.

Wat een beperkte mailbox ziet

De beperking wordt overal afgedwongen en niet alleen in de interface verborgen:

• de Drive-ruimte ontbreekt in GET /api/v1/drive/spaces
• de bestanden antwoorden met 404 wanneer ze op id worden opgevraagd
• er kan geen synchronisatieapparaat voor worden gemaakt; POST /api/v1/drive/devices retourneert 422 drive_disabled
• in webmail ontbreken Drive in de zijbalk, uploaden via slepen en neerzetten en Drive-resultaten in zoekopdrachten

Er wordt niets verwijderd wanneer je het niveau wijzigt. Bestanden die al zijn opgeslagen, blijven staan en de persoon kan er simpelweg niet bij. Dit betekent ook dat Drive uitschakelen de ruimte niet vanzelf teruggeeft. Het tabblad Limieten van het dashboard laat zien wat een mailbox bewaart en kan die bestanden permanent verwijderen als je de ruimte wilt terugwinnen.

Mogelijke fouten