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.

GET/api/v1/threads

Authorization

Authorizationheaderrequired
Bearer token: API key (sk_…), OAuth access token (mcp_…) or mobile session (xk_…).
Scope: crm.read

Query parameters

kindstringoptional
Record type.
Valuescustomeroppvisitdemotaskofferticketcontract
idintegeroptional
Record id.
filterstringoptional
waiting awaiting reply, replied, mine.
Valuesallwaitingrepliedmine
qstringoptional
Subject or address contains.
categorystringoptional
Category 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"
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.