Workspace

List notifications

The user's latest notifications (newest first) and the unread count. Each row: kind (type — mention, comment, task, assign, approval, deal, ticket, email, call, summary, flow, support — a reply from Solk support, system), kind_label, title (short title, e.g. Quote awaits your approval), body (description, e.g. T-2026-0044 · Kuzey Plastik A.Ş. · 14% discount), message (the old one-line text), link, is_read, created_at and nav (the app screen to open, or null). With v=2 also actor (the person whose action caused the notification: id, name, initials, color, photo) and alt (the related record for a link the app has no screen for — e.g. a support ticket → its company: screen, id, label, name); the response adds last_id, more (older ones exist), filter, filters. System notifications (licence, usage invoice, background jobs) only come with filter=system (admins) and are not counted in unread. Without v the old shape: no system notifications, and a link the app has no screen for is empty (link: "").

GET/api/v1/notifications

Authorization

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

Query parameters

vstringoptional
2 = the new shape with title, description, person and related record.
filterstringoptional
Only with v=2: filter.
Valuesallunreadmentionassignapprovalsystem
sinceintegeroptional
Only newer than this id (polling for new notifications while the app is open).
beforeintegeroptional
Only older than this id (paging).
limitintegeroptional
Max rows (1–100, default 50).
Request
curl "https://ornek.solk.app/api/v1/notifications?v=2&limit=5" \
  -H "Authorization: Bearer $SOLK_API_KEY"
Response
{
  "filter": "all",
  "filters": [
    {
      "k": "all",
      "label": "Tümü"
    },
    {
      "k": "unread",
      "label": "Okunmamış"
    }
  ],
  "last_id": 3,
  "more": false,
  "ok": true,
  "rows": [
    {
      "actor": {
        "color": "#b95ccd",
        "id": 2,
        "initials": "AD",
        "name": "Ayşe Demir",
        "photo": null
      },
      "alt": null,
      "body": "@Deniz yarın fiyatı konuşalım, iskonto %12'yi geçmesin.",
      "created_at": "2026-10-15T10:59:07",
      "id": 3,
      "is_read": false,
      "kind": "mention",
      "kind_label": "Bahsetme",
      "link": "/customers/1?note=1#cNotes",
      "message": "Ayşe Demir sizden bahsetti: @Deniz yarın fiyatı konuşalım, iskonto %12'yi geçmesin.",
      "nav": {
        "id": 1,
        "screen": "customer"
      },
      "title": "Ayşe Demir sizden bahsetti"
    },
    {
      "actor": {
        "color": "#b95ccd",
        "id": 2,
        "initials": "AD",
        "name": "Ayşe Demir",
        "photo": null
      },
      "alt": null,
      "body": "Yeni Müşteri · 2026 · Alize Paketleme San. ve Tic. A.Ş.",
      "created_at": "2026-10-15T10:42:07",
      "id": 2,
      "is_read": false,
      "kind": "assign",
      "kind_label": "Devir",
      "link": "/opportunities/1",
      "message": "Size devredilen fırsat: Alize Paketleme San. ve Tic. A.Ş. · Yeni Müşteri · 2026",
      "nav": {
        "id": 1,
        "screen": "opp"
      },
      "title": "Fırsat size devredildi"
    }
  ],
  "unread": 3
}

Example responses were captured from a v98 installation running sample data; lists are shortened to two items.