Mail

me

54 uç · /api/mail/v1/me

İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 54 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/me/2fa-status

Self-service 2FA durumu: TOTP etkin mi + tenant zorunlu mu + enrollment gerekiyor mu

Oturum

(login sonrası istemci enroll'a yönlendirir — post-login enroll; BLE-3636).

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

Confirm 2fa

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

Disable 2fa

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

Enroll 2fa

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

Yaz-gönder (webmail). Gönderen = oturum-mailbox'ı (spoofing-yok: From ZORLA kendi adresi). Her alıcıya

Oturum

(To+Cc+Bcc) public_api zinciri: resolve_sender→is_suppressed→check_send_allowed→warmup→save_outbound→ record_accepted_lane("transactional"), taze message_id. Sent-kopya saklanır. Teslim = worker (DKIM+SMTP).

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

List groups ep

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

Create group ep

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

Rename group ep

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

Delete group ep

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

List group members ep

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

Add group member ep

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

Remove group member ep

OturumYol parametresi: idcontact_id
İstek
curl -X DELETE "https://{slug}.bmail.blesyum.app/api/mail/v1/me/contact-groups/<id>/members/<contact_id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/me/contacts

List contacts ep

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

Add contact ep

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

Get contact ep

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

Update contact ep

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

Delete contact ep

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

Adres defterini dışa aktar (GDPR-taşınabilirlik + yedek). `format=csv` veya `vcard` (varsayılan).

Oturum

İndirilebilir dosya olarak döner (Content-Disposition attachment).

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

Import contacts ep

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

List imports ep

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

Taslak kaydet (Drafts klasörü). Var-olan draft_id verilirse eskisini sil (güncelle). Döner: yeni id.

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

Email doğrulama token'ı üret (recovery_email'e gönderilecek raw token; eskiler geçersizleşir).

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

MF10: mailbox'ı mbox formatında indir (taşınabilir yedek/göç + GDPR-taşınabilirlik).

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

List filters

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

Add filter

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

Delete filter

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

Set filter enabled

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

Derlenmiş Sieve önizleme (motor bunu çalıştırır).

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

Klasör listesi + rozetler. Standart klasörler daima; özel klasörler + mesaj-içeren klasörler eklenir.

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

Create folder ep

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

Delete folder ep

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

Rename folder ep

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

Identity ep

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

Set identity ep

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

Logout: bu token'ın oturumunu iptal et.

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

Klasördeki mesajlar (en-yeni önce) + snippet + ek-var-mı. Snippet için her mesaj parse edilir

Oturum

(bounded: LIST_SNIPPET_MAX). Enc gövde açılır → parse → snippet (metadata'dan From/Subject/tarih).

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

Bir mesajı oku (tam detay). Raw parse → başlıklar + gövde (HTML sanitize/cid-rewrite/remote-block) +

OturumYol parametresi: id

ek-listesi. Otomatik okundu-işaretlenir (INBOX rozet doğru). Yoksa 404.

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

Sil = Trash'e taşı (zaten Trash/Drafts'taysa kalıcı-sil). Gmail-deseni.

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

Eki indeksle indir (Content-Disposition attachment). Yoksa 404.

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

Inline-resmi content-id ile getir (sanitize edilmiş HTML'deki `cid:` referansları). inline → tarayıcı gösterir.

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

BLE-3639: mesajı "spam değil" (ham) işaretle → Bayes ham-eğitimi (yanlış-pozitif düzeltme).

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

BLE-3639: mesajı "spam" işaretle → Bayes sınıflandırıcıyı bu mailbox'ın mesajıyla eğit (geri-bildirim).

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

Move message ep

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

Ham RFC5322 kaynağı (görüntüle-orijinal). text/plain indirilebilir.

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

Set seen ep

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

List notif prefs

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

Bir bildirim kategorisini aç/kapat (transactional/güvenlik kapatılamaz → 403).

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

Parola değiştir: eski-doğrula + güç-doğrula + hash → yaz + `password_changed_at` + **TÜM oturumları

Oturum

revoke** (parola değişince her cihaz yeniden giriş yapmalı).

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

Self-service parola durumu: zorunlu-değişim bayrağı + son değişim zamanı (istemci değişime zorlar).

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

Self-service güvenlik-etkinlik akışı: kullanıcının kendi olayları (login/yeni-cihaz/kilit/parola).

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

Mailbox'ın aktif oturumları (self-service session yönetimi).

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

Belirli oturumu iptal (kendi oturumlarından; yoksa 404).

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

TAM mailbox Sieve (filtre + tatil + yönlendirme birleşik; motor-push için).

Oturum
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/me/sieve" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
Bu sayfa işine yaradı mı?