API Referansı · Oturumlar ve Mesajlar

Sohbet Oturumları ve Mesajlar API'si

Sohbet oturumları oluşturun, listeleyin, yeniden adlandırın, sabitleyin, yıldızlayın ve silin; ayrıca izlenen düzenleme geçmişi ve geri alma özellikleriyle oturum içindeki bireysel mesajları yönetin.

← Belgeler'e dön Uç noktalara atla

Oturum Uç Noktaları

POST /api/v1/sessions

GET /api/v1/sessions

GET /api/v1/sessions/{session_id}/messages

PATCH /api/v1/sessions/{session_id}

DELETE /api/v1/sessions/{session_id}

Mesaj Uç Noktaları

GET /api/v1/messages/{message_id}

PATCH /api/v1/messages/{message_id}

GET /api/v1/messages/{message_id}/history

POST /api/v1/messages/{message_id}/undo

DELETE /api/v1/messages/{message_id}

Oturum Oluştur — İstek Gövdesi

json

{
  "title": "Untitled Chat",
  "kind": "chat",
  "folder_id": null,
  "agent_id": null,
  "metadata": {}
}

workspace_id, kişisel çalışma zamanında istemciden kabul edilmez; aksi takdirde etkin workspace çalışma zamanı bağlamıyla eşleşmesi gerekir — asla rastgele bir istemci tarafından geçersiz kılma olarak kullanılmaz.

Liste — Sorgu Parametreleri ve Yanıt

kindagent_idpinnedlimit (varsayılan 50, maksimum 200)offset (varsayılan 0)

json

{
  "items": [ { "id": "...", "title": "...", "pinned": false, "...": "..." } ],
  "total": 12,
  "limit": 50,
  "offset": 0
}

Oturumu Güncelle (PATCH)

İstek gövdesinde en az bir alan bulunmalıdır — boş bir PATCH reddedilir.

başlıksabitlenmişyıldızlıokunmadı olarak işaretlendi

json

{
  "pinned": true,
  "starred": false
}

Oturum Davranışları

Bir oturum tam olarak bir sahibine aittir (bir kullanıcı, isteğe bağlı olarak bir workspace kapsamında olabilir) — bu, istemci verileriyle değil, kimlik doğrulanmış istek bağlamıyla belirlenir.
Oturumun silinmesi yumuşak silmedir (deleted_at ayarlanır); oturum ve mesajları veritabanında kalır ancak tüm standart sorgulardan hariç tutulur.
GET /sessions/{session_id}/messages, mesajlardan canlı hesaplanan bir mesaj sayısı döndürür; önbelleğe alınmış bir sayaç kullanılmaz.
session_id ve message_id yol parametreleri UUID olarak doğrulanır — hatalı biçimlendirilmiş bir ID sunucu hatası yerine temiz bir doğrulama hatası döndürür.
Pazarlama sitesi demo oturumları kullanıcı başına 3 ile sınırlıdır; bu sınır aşıldığında 403 döndürülür.

Mesaj Düzenleme Geçmişi ve Geri Alma

Bir mesajın içeriği veya payload'ındaki her düzenleme, değişiklik uygulanmadan önce kaydedilir; önceki sürüm korunur.

json

[
  {
    "id": "8f14e...",
    "old_content": "Original message text",
    "old_payload": null,
    "edited_at": "2026-07-30T16:40:00Z"
  }
]

Bir mesaj yalnızca ait olduğu oturumun sahibi tarafından düzenlenebilir veya silinebilir.
Geri al, en son kaydedilmiş sürümü geri yükler ve o geçmiş girişini kaldırır — son düzenlemeden daha geriye gidilmez.
Bir mesajın düzenlenmesi veya silinmesi oturumun önbelleğe alınmış mesaj sayısı alanını değiştirmez; bu alan her zaman canlı sayıyı gösterir.

Hata Modelleri

400

Geçersiz istek — ör. boş bir PATCH gövdesi veya algılanan değişiklik olmaması.

401

Eksik veya geçersiz kimlik doğrulaması.

404

Oturum veya mesaj bulunamadı (ya da çağıranın mülkiyetinde değil).

Örnekler

Oturum Oluştur

bash

curl -X POST "/api/v1/sessions" \
  -H "Authorization: Bearer [token]" \
  -H "Content-Type: application/json" \
  -d '{"title": "New Chat", "kind": "chat"}'

Oturumu Sabitle

bash

curl -X PATCH "/api/v1/sessions/[session_id]" \
  -H "Authorization: Bearer [token]" \
  -H "Content-Type: application/json" \
  -d '{"pinned": true}'

Mesajı Düzenle

bash

curl -X PATCH "/api/v1/messages/[message_id]" \
  -H "Authorization: Bearer [token]" \
  -H "Content-Type: application/json" \
  -d '{"content": "Corrected message text"}'

Son Düzenlemeyi Geri Al

bash

curl -X POST "/api/v1/messages/[message_id]/undo" \
  -H "Authorization: Bearer [token]"