Mail

mailboxes

32 uç · /api/mail/v1/mailboxes

İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 32 ucun elle doğrulanmış gövde örneği henüz yok; o uçlarda iskelet gövdesizdir — uydurma bir alan yazmıyoruz.

GET/api/mail/v1/mailboxes

Mailbox'ları listele — **sayfalı + aramalı** (100M-ölçek: bir domain 100k+ mailbox olabilir →

Oturum

sınırsız liste OOM-riski). `domain_id` filtresi + `query` (local_part/görünen-ad ILIKE) + `limit` [1,500]-clamp + `offset`. Silinenler hariç, local_part sıralı.

İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/mailboxes

Mailbox ekle: seat-kota enforce (mail_mailboxes, HARD, advisory-lock ile TOCTOU-safe) → insert

Oturum

(status=active, şifresiz — `set_password` ile ayrı set edilir). case-insensitive dup → 409.

İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
DELETE/api/mail/v1/mailboxes/{id}

Remove mailbox

OturumYol parametresi: id
İstek
curl -X DELETE "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/mail/v1/mailboxes/{id}/abuse-exempt

Admin-override: mailbox'ı kötüye-kullanım oto-kısıtlamasından muaf tut/kaldır (BLE-3693).

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/abuse-exempt" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/mailboxes/{id}/abuse-scan

Mailbox kötüye-kullanım/ele-geçmişlik sinyali (son 1s hacim+bounce+şikayet; salt rapor).

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/abuse-scan" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/mailboxes/{id}/app-passwords

Mailbox'ın app-şifreleri (hash'siz; revoked dahil, durum görünür).

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/app-passwords" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/mailboxes/{id}/app-passwords

App-şifre oluştur → (id, DÜZ-şifre). Düz-şifre çağırana BİR KEZ döner (bir daha görünmez).

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/app-passwords" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/mailboxes/{id}/backup

MF13 · mailbox'ı mbox olarak yedekle (admin DR/göç; indirilebilir arşiv). RBAC + audit.

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/backup" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/mailboxes/{id}/delegates

List delegates ep

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/delegates" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/mailboxes/{id}/delegates

Grant delegate ep

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/delegates" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/mailboxes/{id}/force-password-change

Admin: sonraki girişte parola değişimini zorunlu kıl (BLE-3747).

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/force-password-change" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/mail/v1/mailboxes/{id}/forward

Yönlendirme ayarla (`forward_to=None` → kapat). keep_local=false → yerel kopya tutma (yalnız forward).

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/forward" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/mailboxes/{id}/gdpr

Create gdpr

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/gdpr" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/mailboxes/{id}/legal-holds

Yapılandırılmış legal-hold koy (gerekçe + tarih-kapsamı; referans-sayımlı).

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/legal-holds" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/mailboxes/{id}/migrate

Create migration

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/migrate" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/mail/v1/mailboxes/{id}/password

Mailbox şifresi ata/değiştir — güç-doğrulama + argon2 hash ÇEKİRDEKTEN. Silinmiş mailbox'a set edilmez.

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/password" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/mailboxes/{id}/password-reset

Request pw reset ep

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/password-reset" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/mailboxes/{id}/prefs

Get prefs ep

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/prefs" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/mail/v1/mailboxes/{id}/quota

Set quota ep

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/quota" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/mailboxes/{id}/restore

MF13 · mbox arşivini bir mailbox'a geri-yükle (admin DR/göç). Gövde = ham mbox metni. RBAC + audit.

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/restore" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/mailboxes/{id}/restrict

Tara → compromised ise mailbox'ı askıya al (oto-throttle) + `mail.account.restricted` alarm webhook.

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/restrict" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/mailboxes/{id}/send-as

Grant send as ep

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/send-as" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/mailboxes/{id}/send-rate

Per-mailbox gönderim-hızı metriği (son 1s/24s kabul; rate-limit tüketim gözlemi — BLE-3679).

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/send-rate" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/mail/v1/mailboxes/{id}/signature

Set signature ep

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/signature" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/mail/v1/mailboxes/{id}/status

Mailbox durumu değiştir (active↔suspended). 'deleted' için `delete_mailbox` kullan.

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/status" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/mailboxes/{id}/unlock

Admin: kilitli mailbox'ı elle aç (brute-force kilit-reset; BLE-3789). audit'li.

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/unlock" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/mailboxes/{id}/usage

Mailbox usage

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/usage" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/mail/v1/mailboxes/{id}/vacation

Set vacation ep

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/<id>/vacation" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/mailboxes/bulk

Bulk import

Oturum
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/bulk" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/mailboxes/bulk/action

Toplu mailbox aksiyonu (suspend/activate/delete/force_password_change; per-item sonuç). audit'li.

Oturum
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/bulk/action" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/mailboxes/bulk/preview

Dry-run önizleme: mutasyonsuz doğrulama (import öncesi neyin başarılı/başarısız olacağı).

Oturum
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/mailboxes/bulk/preview" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
Bu sayfa işine yaradı mı?
Hâlâ takıldın mı? Destek al