Aksiyonlar ve görevler

Görev oluştur

Görev açar; assigned_to yoksa isteği yapana atanır. Firma bağlamak isteğe bağlıdır (kimlik ya da adla); kendiliğinden proje açılmaz — opp_id ile mevcut projeye, opp_name ile yeni projeye bağlanır.

POST/api/v1/tasks

Yetkilendirme

Authorizationheaderzorunlu

Bearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).

Modül: Yapılacak işlerKapsam: crm.write

Gövde application/json

titlestringzorunlu

Görev başlığı.

due_datestringisteğe bağlı

Termin (YYYY-MM-DD).

due_timestringisteğe bağlı

Saat (HH:MM).

prioritystringisteğe bağlıvarsayılan: Normal

Öncelik.

DeğerlerDüşükNormalYüksekAcil

detailstringisteğe bağlı

Ayrıntı.

assigned_tointegeristeğe bağlı

Atanan kullanıcı.

customer_idintegeristeğe bağlı

Firma kimliği.

customerstringisteğe bağlı

Firma adı (kimlik bilinmiyorsa).

opp_idstringisteğe bağlı

Proje kimliği ya da __none__ (projesiz).

opp_namestringisteğe bağlı

Yeni proje adı.

Hatalar

HTTP	error	Anlamı
`400`	`invalid`	Eksik ya da geçersiz alan (`message` ayrıntıyı verir).

İstek

curl -X POST https://ornek.solk.app/api/v1/tasks \
  -H "Authorization: Bearer $SOLK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Fiyat listesini gönder",
  "customer_id": 31,
  "due_date": "2026-10-04",
  "due_time": "10:30",
  "priority": "Yüksek",
  "detail": "2027 listesi, €/kg"
}'

const res = await fetch("https://ornek.solk.app/api/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "title": "Fiyat listesini gönder",
    "customer_id": 31,
    "due_date": "2026-10-04",
    "due_time": "10:30",
    "priority": "Yüksek",
    "detail": "2027 listesi, €/kg"
  }),
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    json={
        "title": "Fiyat listesini gönder",
        "customer_id": 31,
        "due_date": "2026-10-04",
        "due_time": "10:30",
        "priority": "Yüksek",
        "detail": "2027 listesi, €/kg"
    },
)
print(r.json())

Yanıt

{
  "action": {
    "act": {
      "addr": "Bursa",
      "c": 31,
      "mail": "emre.yildiz@kuzeyplastik.com.tr",
      "n": "Kuzey Plastik Sanayi",
      "tel": "+90 532 555 11 22",
      "url": "/customers/31",
      "wa": "905325551122",
      "who": "Emre Yıldız"
    },
    "chain_after": [],
    "chain_before": [],
    "customer": "Kuzey Plastik Sanayi",
    "customer_id": 31,
    "date": "2026-10-04",
    "detail": "2027 listesi, €/kg",
    "done": false,
    "done_at": null,
    "editable": true,
    "icon": "📋",
    "id": 23,
    "key": "task:23",
    "kind": "task",
    "label": "Fiyat listesini gönder",
    "opp": "",
    "opp_id": null,
    "others": [
      {
        "customer": "",
        "customer_id": null,
        "date": "2026-10-05",
        "icon": "⚡",
        "id": 106,
        "key": "visit:106",
        "kind": "visit",
        "label": "Teklif gönder",
        "opp": "Streç film tedariki",
        "opp_id": 53,
        "src": "Ziyaret",
        "state": "soon",
        "url": "/action/visit/106"
      }
    ],
    "result": "",
    "rid": "00TxuMVTniYx44l",
    "src": "Görev",
    "state": "soon",
    "threads": [],
    "threads_n": 0,
    "user": {
      "full_name": "Deniz Aksoy",
      "id": 1,
      "role": "admin",
      "role_label": "Yönetici",
      "username": "admin"
    }
  },
  "ok": true,
  "task": {
    "assignee": {
      "full_name": "Deniz Aksoy",
      "id": 1,
      "role": "admin",
      "role_label": "Yönetici",
      "username": "admin"
    },
    "completed_at": null,
    "customer": "Kuzey Plastik Sanayi",
    "customer_id": 31,
    "detail": "2027 listesi, €/kg",
    "due_date": "2026-10-04",
    "due_time": "10:30",
    "id": 23,
    "opp": "",
    "opp_id": null,
    "priority": "Yüksek",
    "result": "",
    "rid": "00TxuMVTniYx44l",
    "source_key": "",
    "state": "soon",
    "status": "Açık",
    "title": "Fiyat listesini gönder"
  }
}

Örnek yanıt örnek veriyle çalışan bir v22 kurulumundan alındı; listeler en çok iki öğeyle kısaltıldı.