Actions & tasks

List actions

Open work in one list: tasks, next actions of visits and trials, dated project steps. Use each row's kind + id with the complete / postpone endpoints.

GET/api/v1/actions

Authorization

Authorizationheaderrequired

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

Module: TasksScope: crm.read

Query parameters

scopestringoptional

mine = records I own (default for sales users), all = every record I can see (default for admins), or a user id.

statestringoptional

Due state.

Valuestodayoverduesoonopenweek

customer_idintegeroptional

Only this company.

Request

curl "https://ornek.solk.app/api/v1/actions?scope=all&state=overdue" \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/actions?scope=all&state=overdue", {
  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/actions",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    params={"scope": "all", "state": "overdue"},
)
print(r.json())

Response

{
  "counts": {
    "overdue": 9,
    "soon": 0,
    "today": 0
  },
  "ok": true,
  "rows": [
    {
      "customer": "Lotus Medikal Ambalaj San. Tic. Ltd. Şti.",
      "customer_id": 3,
      "date": "2026-09-26",
      "icon": "📋",
      "id": 1,
      "key": "task:1",
      "kind": "task",
      "label": "Numune sonucu için ara",
      "opp": "Yeni Müşteri · 2026",
      "opp_id": 33,
      "src": "Görev",
      "state": "overdue",
      "url": "/action/task/1"
    },
    {
      "customer": "Hanımeli Etiket San. Tic. Ltd. Şti.",
      "customer_id": 23,
      "date": "2026-09-26",
      "icon": "📋",
      "id": 17,
      "key": "task:17",
      "kind": "task",
      "label": "Fiyat listesini güncelleyip gönder",
      "opp": "Mevcut Müşteri — Yenileme · 2026",
      "opp_id": 23,
      "src": "Görev",
      "state": "overdue",
      "url": "/action/task/17"
    }
  ],
  "total": 9
}

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