Drive für ein Postfach per API deaktivieren

Der Speicher wird im gesamten Konto gemeinsam genutzt. Wenn eine Person Drive als persönlichen Cloudspeicher verwendet, verbraucht sie deshalb den Platz, den andere für E-Mails benötigen. Jedes Postfach hat eine drive_access-Stufe, die festlegt, auf wie viel von Drive sein Benutzer zugreifen kann. Diese Seite dient als Befehlsreferenz für diese Einstellung.

Dieselbe Einstellung finden Sie im Dashboard unter Postfächer → (ein Postfach) → Limits. Sie ist in jedem Tarif ohne Zusatzkosten verfügbar.

Die drei Stufen

full ist der Standardwert und gilt für alle bestehenden Postfächer. Der Empfang ist nie betroffen: Ein großer Anhang, den jemand an das Postfach sendet, lässt sich unabhängig von der Stufe wie gewohnt im Webmail öffnen.

Erforderlicher Scope

mailboxes:write, derselbe Scope, mit dem auch jedes andere Postfachfeld aktualisiert wird. Beide Endpoints unten akzeptieren einen Idempotency-Key-Header und können sicher erneut aufgerufen werden.

Ein Postfach

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"}'

Das aktualisierte Postfach wird mit der neuen Stufe zurückgegeben:

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

drive_access wird auch von GET /api/v1/mailboxes/{id} und vom Listen-Endpoint zurückgegeben. So können Sie die Einstellung prüfen, ohne etwas zu ändern.

Mehrere Postfächer auf einmal

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"}'

Übergeben Sie genau einen Selektor:

Die Antwort zeigt, was geschehen ist:

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

matched ist die Anzahl der vom Selektor gefundenen Postfächer und updated die Anzahl der tatsächlich geänderten Postfächer. Postfächer, die bereits die angeforderte Stufe haben, werden gefunden, aber nicht aktualisiert. Ein erneuter Aufruf ist deshalb unproblematisch. Das ist hilfreich, wenn Sie neuen Postfächern regelmäßig einen Standardwert zuweisen.

Auf neue Postfächer anwenden

Beim Erstellen eines Postfachs kann drive_access nicht angegeben werden; neue Postfächer beginnen mit full. Um ein Postfach bereitzustellen, das nie Drive-Zugriff hatte, erstellen Sie es und legen anschließend die Stufe fest:

# 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"}'

Wenn Sie Postfächer stapelweise erstellen, ist es einfacher, zunächst alle anzulegen und danach einen einzigen Sammelaufruf mit domain_id auszuführen.

Mit einem MCP-Agenten

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

Das Tool akzeptiert dieselben drei Selektoren wie der REST-Endpoint und gibt dieselben Anzahlen zurück. Für ein einzelnes Postfach funktioniert auch update_mailbox(mailbox_id=1701, drive_access="disabled").

Gemeinsame Postfächer

Der Einzel-Endpoint lehnt gemeinsame Postfächer mit 422 drive_access_not_applicable ab. Der Sammel-Endpoint überspringt sie, zählt sie aber mit. Niemand meldet sich direkt bei einem gemeinsamen Postfach an: Ihr Team öffnet es vom eigenen Postfach aus, daher gilt die Stufe dieses Mitgliederpostfachs. Eine Person, für die Sie Drive deaktiviert haben, kann weder auf die Dateien eines gemeinsamen Postfachs zugreifen noch es zum Umgehen der Einstellung verwenden.

Was ein eingeschränktes Postfach sieht

Die Einschränkung wird überall durchgesetzt und nicht nur in der Oberfläche verborgen:

• sein Drive-Speicher fehlt in GET /api/v1/drive/spaces
• seine Dateien antworten bei einem Abruf per id mit 404
• es kann kein Synchronisierungsgerät dafür erstellt werden; POST /api/v1/drive/devices gibt 422 drive_disabled zurück
• im Webmail fehlen Drive in der Seitenleiste, das Hochladen per Drag-and-drop und Drive-Ergebnisse in der Suche

Beim Ändern der Stufe wird nichts gelöscht. Bereits gespeicherte Dateien bleiben an ihrem Ort und sind für die Person lediglich nicht erreichbar. Das bedeutet auch, dass die Deaktivierung von Drive den Speicherplatz nicht von selbst zurückgibt. Der Tab Limits im Dashboard zeigt, was ein Postfach speichert, und kann diese Dateien dauerhaft löschen, wenn Sie den Platz zurückerhalten möchten.

Mögliche Fehler