Ekip Yönetimi

Üyeleri çalışma alanınıza davet ederek ekibinizle iş birliği yapın. Her üyeye izinlerini belirleyen bir rol atanır.

RollerBölüm bağlantısını kopyala

Rol İzinleriBölüm bağlantısını kopyala

Member salt okunur değildir ve anahtar yönetiminden hariç tutulmamıştır: neredeyse her şeyi oluşturabilir ve düzenleyebilir. Yalnızca API anahtarlarını, alan adlarını ve webhook'ları silmek, ayrıca ekip/sahiplik yönetimi Admin'e özeldir.

Ekip Genel BakışBölüm bağlantısını kopyala

Mevcut ekip üyelerini ve bekleyen davetleri alın:

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
}

Bu yanıtta id, userId, firstName/lastName, roleName/statusName, invitedBy, memberCount veya invitationCount yoktur: bunun yerine yukarıdaki alan adlarını kullanın. maxMembers workspace'in planını yansıtır: Free ve Pro'da 10, Max'te sınırsız. Bir koltuk, aktif bir üye (owner dahil) veya süresi dolmamış, bekleyen bir davettir; askıya alınmış üyeler ile süresi dolmuş, iptal edilmiş veya kabul edilmiş davetler koltuk saymaz. Limitteyken davet etme, kabul etme, yeniden etkinleştirme ve ilk SSO girişi 400 PLAN_LIMIT_REACHED döner. Plan düşürüldüğünde kimse çıkarılmaz veya askıya alınmaz: bu yalnızca workspace yeni limitin üzerindeyken yeni katılımları engeller.

Üye DurumlarıBölüm bağlantısını kopyala

Davet DurumlarıBölüm bağlantısını kopyala

Küçük harfli dizeler olarak döner:

Ekip Üyesi Davet EtmeBölüm bağlantısını kopyala

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

Davet edilen kullanıcı, daveti kabul etmek için bir bağlantı içeren e-posta alır. Davetler 7 gün sonra sona erer.

Daveti Kabul EtmeBölüm bağlantısını kopyala

Bir daveti kabul etmek için tek bir genel rota vardır: sürümlenmemiştir (/v1 yolun bir parçası değildir) ve bir id yerine davet tokenıyla anahtarlanır:

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

Mevcut bir MailLand kullanıcısı için önce davet edilen e-posta adresiyle oturum açın, ardından bu rotayı boş veya minimal bir gövdeyle çağırın, firstName/lastName/password gerekmez. Tamamen yeni bir kullanıcı için, hesabı oluşturmak ve tek adımda kabul etmek üzere aynı çağrıda fullName ve password gönderin.

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

Davet Bilgilerini AlmaBölüm bağlantısını kopyala

Kabul etmeden önce davet ayrıntılarını alın (genel, kimlik doğrulama gerekmez, token ile anahtarlanır, /v1 değil):

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

Davetleri YönetmeBölüm bağlantısını kopyala

Daveti İptal EtmeBölüm bağlantısını kopyala

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..."

Başarılı olursa 204 No Content döner.

Daveti Yeniden GöndermeBölüm bağlantısını kopyala

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..."

Daveti yeniden göndermek, 7 günlük son kullanma süresini sıfırlar.

Üye Rolünü GüncellemeBölüm bağlantısını kopyala

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

Adminler yalnızca Member/Viewer rollerini yönetebilir: bir üyeyi Admin'e yükseltemez veya başka bir Admin'in rolünü değiştiremezler. Bunu yalnızca Owner yapabilir.

Askıya Alma ve Askıyı KaldırmaBölüm bağlantısını kopyala

Bir üyenin erişimini geçici olarak askıya alın:

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

Bir { reason?, credentialDecision?, transferToMemberId? } gövdesi, askıya alma sırasında o üyenin API anahtarlarına ne olacağını kontrol eder. credentialDecision, yalnızca üyenin en az bir canlı API anahtarı varsa zorunludur: bu durumda gönderilmezse çağrı, açığa çıkan anahtarları details içinde listeleyerek 400 CREDENTIAL_DECISION_REQUIRED döner. Aksi hâlde gövdenin tamamı atlanabilir.

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

Askıya alınan bir üyeyi geri yükleyin:

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..."

Askıya alınan üyeler çalışma alanında oturum açamaz; API anahtarları, askıya alma sırasında verilen kimlik bilgisi kararını izler: keep ile üyenin anahtarları çalışmaya devam eder.

Üye KaldırmaBölüm bağlantısını kopyala

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

Kaldırma işlemi aynı kimlik bilgisi kararını sorgu parametreleri olarak kabul eder:

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

Askıya almada olduğu gibi, üye canlı bir API anahtarına sahipse credentialDecision zorunludur; aksi hâlde çağrı 400 CREDENTIAL_DECISION_REQUIRED döner.

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

Üye, çalışma alanından kaldırılır ve tüm çalışma alanı kaynaklarına erişimi anında sona erer.

Sahiplik DevriBölüm bağlantısını kopyala

Çalışma alanı sahipliğini başka bir üyeye devredin:

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

Hedef, aktif bir Admin olmalıdır (bir Member veya Viewer değil).

Hata YanıtlarıBölüm bağlantısını kopyala

MEMBER_ALREADY_EXISTS diye bir kod yoktur: hem "zaten üye" hem de "davet zaten var" 409 CONFLICT döner.

POST /v1/account/team/leave (çalışma alanından kendiniz ayrılma) ve GET /v1/account/team/me (kendi üyelik kaydınız) da mevcuttur ve bu sayfanın başka bir yerinde belgelenmemiştir.

Sonraki AdımlarBölüm bağlantısını kopyala

• Çalışma Alanları: çalışma alanı ayarlarını yönetin
• Kimlik Doğrulama: kimlik doğrulama ve oturumlar
• Faturalandırma: abonelik ve ödeme yönetimi