List threads
E-mail threads either for one record (kind + id) or the inbox (filter, q). Content follows the user's permission to see it.
Authorization
AuthorizationheaderrequiredBearer token: API key (sk_…), OAuth access token (mcp_…) or mobile session (xk_…).
Scope:
crm.readQuery parameters
kindstringoptionalRecord type.
Values
customeroppvisitdemotaskofferticketcontractidintegeroptionalRecord id.
filterstringoptionalwaiting awaiting reply, replied, mine.Values
allwaitingrepliedmineqstringoptionalSubject or address contains.
categorystringoptionalCategory key (v50; see
/me → constants.mail_categories). Rows carry category, category_label, category_color and category_source (rule keywords · ai · user set by hand).Request
curl "https://ornek.solk.app/api/v1/threads?filter=all" \
-H "Authorization: Bearer $SOLK_API_KEY"const res = await fetch("https://ornek.solk.app/api/v1/threads?filter=all", {
headers: {
Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
},
});
const data = await res.json();import os, requests
r = requests.get(
"https://ornek.solk.app/api/v1/threads",
headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
params={"filter": "all"},
)
print(r.json())Response
{
"items": [
{
"category": "musteri",
"category_color": "#2a78d6",
"category_label": "Müşteri yazışması",
"category_source": "rule",
"customer": "Alize Paketleme San. ve Tic. A.Ş.",
"customer_id": 1,
"id": 1,
"last_at": "2026-10-15T06:02:00",
"last_dir": "in",
"n": 2,
"opp": "Mevcut Müşteri — Yenileme · 2026",
"opp_how": "single",
"opp_id": 31,
"opp_note": "firmanın tek açık projesi",
"peer": "Selin Doğan",
"subject": "Tanışma görüşmesi ve teknik föyler",
"suggested": false,
"waiting": true
},
{
"category": "musteri",
"category_color": "#2a78d6",
"category_label": "Müşteri yazışması",
"category_source": "rule",
"customer": "Ihlamur Matbaacılık A.Ş.",
"customer_id": 4,
"id": 4,
"last_at": "2026-10-15T06:02:00",
"last_dir": "in",
"n": 2,
"opp": "Mevcut Müşteri — Ek Satış · 2026",
"opp_how": "single",
"opp_id": 34,
"opp_note": "firmanın tek açık projesi",
"peer": "Nazlı Aydın",
"subject": "Tanışma görüşmesi ve teknik föyler",
"suggested": false,
"waiting": true
}
],
"mailbox": {
"connected": true,
"email": "deniz@ornekkimya.com.tr",
"error": "",
"signature": false,
"status": "ok"
},
"ok": true,
"total": 21
}Example responses were captured from a v98 installation running sample data; lists are shortened to two items.