Administración de Equipo

Colabore con su equipo invitando miembros a su espacio de trabajo. A cada miembro se le asigna un rol que determina sus permisos.

RolesCopiar enlace de la sección

Permisos por rolCopiar enlace de la sección

Member no es de solo lectura ni está excluido de la gestión de claves: puede crear y editar casi todo. Solo eliminar claves API, dominios y webhooks, además de la administración del equipo y la propiedad, es exclusivo de Admin.

Resumen del equipoCopiar enlace de la sección

Obtenga los miembros actuales del equipo y las invitaciones pendientes:

GET https://api.mail.land/v1/account/team

curl https://api.mail.land/v1/account/team \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "members": [
    {
      "publicId": "mbr_a1b2c3d4e5",
      "email": "[email protected]",
      "fullName": "John Doe",
      "role": "owner",
      "status": "active",
      "joinedAt": "2026-01-15T08:00:00Z",
      "invitedByEmail": null,
      "isCurrentUser": true
    },
    {
      "publicId": "mbr_f6g7h8i9j0",
      "email": "[email protected]",
      "fullName": "Jane Smith",
      "role": "admin",
      "status": "active",
      "joinedAt": "2026-01-20T10:00:00Z",
      "invitedByEmail": "[email protected]",
      "isCurrentUser": false
    }
  ],
  "pendingInvitations": [
    {
      "publicId": "inv_k1l2m3n4o5",
      "email": "[email protected]",
      "role": "member",
      "status": "pending",
      "createdAt": "2026-02-17T08:00:00Z",
      "expiresAt": "2026-02-24T08:00:00Z",
      "invitedByEmail": "[email protected]",
      "invitedByName": "John Doe",
      "isExpired": false
    }
  ],
  "totalMembers": 2,
  "totalPendingInvitations": 1,
  "maxMembers": 10
}

No hay id, userId, firstName/lastName, roleName/statusName, invitedBy, memberCount ni invitationCount en esta respuesta: use los nombres de campo anteriores. maxMembers refleja el plan del workspace: 10 en Free y Pro, ilimitado en Max. Un cupo es un miembro activo (incluido el owner) o una invitación pendiente sin expirar; los miembros suspendidos y las invitaciones expiradas, revocadas o aceptadas no cuentan. Al llegar al límite, invitar, aceptar, reactivar o el primer inicio de sesión por SSO devuelven 400 PLAN_LIMIT_REACHED. Bajar de plan nunca elimina ni suspende a nadie: solo bloquea nuevas incorporaciones mientras el workspace supere el nuevo límite.

Estados de los miembrosCopiar enlace de la sección

Estados de las invitacionesCopiar enlace de la sección

Se devuelven como cadenas en minúsculas:

Invitar a un miembro del equipoCopiar enlace de la sección

POST https://api.mail.land/v1/account/team/invite

{
  "email": "[email protected]",
  "role": 2
}

curl -X POST https://api.mail.land/v1/account/team/invite \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]", "role": 2 }'

El usuario invitado recibe un correo electrónico con un enlace para aceptar la invitación. Las invitaciones expiran después de 7 días.

Aceptar una invitaciónCopiar enlace de la sección

Existe una única ruta pública para aceptar una invitación: no está versionada (/v1 no forma parte de la ruta) y se identifica por el token de invitación, no por un id:

POST https://api.mail.land/invitations/{token}/accept

Para un usuario existente de MailLand, inicie sesión primero con el correo invitado y luego llame a esta ruta con un cuerpo vacío o mínimo, no se necesitan firstName/lastName/password. Para un usuario completamente nuevo, envíe fullName y password en la misma llamada para crear la cuenta y aceptar en un solo paso.

{
  "fullName": "New Member",
  "password": "SecureP@ssw0rd!"
}

curl -X POST https://api.mail.land/invitations/invitation-token-from-email/accept \
  -H "Content-Type: application/json" \
  -d '{"fullName": "New Member", "password": "SecureP@ssw0rd!"}'

Obtener información de la invitaciónCopiar enlace de la sección

Recupere los detalles de la invitación antes de aceptarla (público, sin autenticación, identificado por el token, no /v1):

GET https://api.mail.land/invitations/{token}

curl "https://api.mail.land/invitations/invitation-token-from-email"

{
  "tenantName": "My Company",
  "role": "member",
  "invitedByName": "John Doe",
  "expiresAt": "2026-02-24T08:00:00Z",
  "isExpired": false,
  "alreadyAccepted": false,
  "existingUserEmail": "[email protected]"
}

Administrar invitacionesCopiar enlace de la sección

Cancelar una invitaciónCopiar enlace de la sección

DELETE https://api.mail.land/v1/account/team/invitations/{id}

curl -X DELETE https://api.mail.land/v1/account/team/invitations/{id} \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Devuelve 204 No Content cuando tiene éxito.

Reenviar una invitaciónCopiar enlace de la sección

POST https://api.mail.land/v1/account/team/invitations/{id}/resend

curl -X POST https://api.mail.land/v1/account/team/invitations/{id}/resend \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Reenviar una invitación restablece el período de expiración de 7 días.

Actualizar el rol de un miembroCopiar enlace de la sección

PATCH https://api.mail.land/v1/account/team/members/{id}/role

{
  "role": 1
}

curl -X PATCH https://api.mail.land/v1/account/team/members/{id}/role \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{ "role": 1 }'

Los Admins solo pueden gestionar roles de Member/Viewer: no pueden ascender a un miembro a Admin ni cambiar el rol de otro Admin. Solo el Owner puede hacerlo.

Suspender y reactivarCopiar enlace de la sección

Suspender temporalmente el acceso de un miembro:

POST https://api.mail.land/v1/account/team/members/{id}/suspend

Un cuerpo { reason?, credentialDecision?, transferToMemberId? } controla qué sucede con las claves API de ese miembro mientras está suspendido. credentialDecision es obligatorio solo cuando el miembro posee al menos una clave API activa: omitirlo en ese caso devuelve 400 CREDENTIAL_DECISION_REQUIRED, con las claves expuestas listadas en details. En caso contrario, se puede omitir todo el cuerpo.

curl -X POST https://api.mail.land/v1/account/team/members/{id}/suspend \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Restaurar un miembro suspendido:

POST https://api.mail.land/v1/account/team/members/{id}/reactivate

curl -X POST https://api.mail.land/v1/account/team/members/{id}/reactivate \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Los miembros suspendidos no pueden iniciar sesión en el espacio de trabajo; sus claves API siguen la decisión de credenciales tomada al suspenderlos: con keep, las claves del miembro siguen funcionando.

Eliminar un miembroCopiar enlace de la sección

DELETE https://api.mail.land/v1/account/team/members/{id}

La eliminación acepta la misma decisión de credenciales, como parámetros de consulta:

DELETE https://api.mail.land/v1/account/team/members/{id}?reason=offboarding&credentialDecision=revoke&transferToMemberId=mbr_f6g7h8i9j0

Al igual que con la suspensión, credentialDecision es obligatorio cuando el miembro posee una clave API activa; de lo contrario, la llamada devuelve 400 CREDENTIAL_DECISION_REQUIRED.

curl -X DELETE https://api.mail.land/v1/account/team/members/{id} \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

El miembro es eliminado del espacio de trabajo y pierde inmediatamente el acceso a todos sus recursos.

Transferir propiedadCopiar enlace de la sección

Transferir la propiedad del espacio de trabajo a otro miembro:

POST https://api.mail.land/v1/account/team/transfer-ownership

{
  "newOwnerMemberId": "mbr_f6g7h8i9j0"
}

curl -X POST https://api.mail.land/v1/account/team/transfer-ownership \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{ "newOwnerMemberId": "mbr_f6g7h8i9j0" }'

El objetivo debe ser un Admin activo (no un Member ni un Viewer).

Respuestas de errorCopiar enlace de la sección

No existe el código MEMBER_ALREADY_EXISTS: tanto "ya es miembro" como "la invitación ya existe" devuelven 409 CONFLICT.

POST /v1/account/team/leave (abandonar el espacio de trabajo usted mismo) y GET /v1/account/team/me (su propio registro de membresía) también existen y no están documentados en otra parte de esta página.

Próximos pasosCopiar enlace de la sección

• Espacios de trabajo: administrar la configuración del espacio de trabajo
• Autenticación: autenticación y sesiones
• Facturación: gestión de suscripciones y pagos