Desactivar Drive para un buzón mediante la API

El almacenamiento se comparte en toda la cuenta, por lo que una persona que trate Drive como almacenamiento personal en la nube consume el espacio que los demás necesitan para el correo. Cada buzón tiene un nivel drive_access que decide a qué parte de Drive puede acceder su usuario. Esta página es la referencia de comandos para configurarlo.

La misma opción se encuentra en el panel, en Buzones → (un buzón) → Límites. Está disponible en todos los planes y no tiene coste adicional.

Los tres niveles

full es el valor predeterminado y es el que tienen todos los buzones existentes. La recepción nunca se ve afectada: un adjunto grande que alguien envíe al buzón se abre desde webmail como siempre, sea cual sea el nivel.

Ámbito requerido

mailboxes:write, el mismo ámbito que actualiza cualquier otro campo del buzón. Los dos endpoints siguientes aceptan una cabecera Idempotency-Key y se pueden reintentar de forma segura.

Un buzón

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

El buzón actualizado se devuelve con el nuevo nivel:

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

drive_access también aparece en la respuesta de GET /api/v1/mailboxes/{id} y en el endpoint de lista, por lo que puedes auditar la configuración sin cambiar nada.

Varios buzones a la vez

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

Proporciona exactamente un selector:

La respuesta indica lo que ha ocurrido:

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

matched indica cuántos buzones encontró el selector y updated, cuántos cambiaron realmente. Los buzones que ya tienen el nivel solicitado se incluyen entre las coincidencias, pero no se actualizan, por lo que repetir la llamada es inofensivo. Esto resulta útil cuando aplicas periódicamente un valor predeterminado a los buzones nuevos.

Aplicarlo a buzones nuevos

La creación de buzones no acepta drive_access; los buzones nuevos comienzan con full. Para aprovisionar un buzón que nunca haya tenido Drive, créalo y configura después el nivel:

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

Si creas buzones por lotes, el patrón más sencillo consiste en crearlos todos y realizar después una sola llamada masiva con domain_id.

Con un agente MCP

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

La herramienta admite los mismos tres selectores que el endpoint REST y devuelve los mismos recuentos. Para un solo buzón también funciona update_mailbox(mailbox_id=1701, drive_access="disabled").

Buzones compartidos

El endpoint individual rechaza los buzones compartidos con 422 drive_access_not_applicable; el endpoint masivo los omite, aunque los incluye en el recuento. Nadie inicia sesión directamente en un buzón compartido: tu equipo lo abre desde su propio buzón, por lo que se aplica el nivel del buzón de ese miembro. Una persona a la que hayas desactivado Drive no puede acceder a los archivos de un buzón compartido ni usarlo para eludir la configuración.

Qué ve un buzón restringido

La restricción se aplica en todas partes, no solo se oculta en la interfaz:

• su espacio de Drive no aparece en GET /api/v1/drive/spaces
• sus archivos responden con 404 cuando se solicitan por id
• no se puede crear un dispositivo de sincronización para él; POST /api/v1/drive/devices devuelve 422 drive_disabled
• en webmail no aparece Drive en la barra lateral, la carga mediante arrastrar y soltar ni los resultados de Drive en las búsquedas

No se elimina nada al cambiar el nivel. Los archivos ya almacenados permanecen donde están y la persona simplemente no puede acceder a ellos. Esto también significa que desactivar Drive no devuelve el espacio por sí solo. La pestaña Límites del panel muestra lo que almacena un buzón y permite eliminar esos archivos permanentemente si quieres recuperar el espacio.

Errores que puedes encontrar