Actions & tasks

Update a task

Only the fields you send change. status: Tamamlandı completes the task (done_on picks the day). PUT and POST are accepted too.

PATCH/api/v1/tasks/{id}

Authorization

Authorizationheaderrequired

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

Module: TasksScope: crm.write

Path parameters

idintegerrequired

Task id.

Body application/json

titlestringoptional

Title.

detailstringoptional

Details.

due_datestringoptional

Due date.

due_timestringoptional

Time (HH:MM).

prioritystringoptional

Priority.

ValuesDüşükNormalYüksekAcil

statusstringoptional

Status.

ValuesAçıkDevam EdiyorTamamlandı

done_onstringoptional

Completion day.

assigned_tointegeroptional

Assignee.

Errors

HTTP	error	Meaning
`403`	`forbidden`	You may not see / edit this record.
`404`	`not_found`	Record not found.

Request

curl -X PATCH https://ornek.solk.app/api/v1/tasks/23 \
  -H "Authorization: Bearer $SOLK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "priority": "Acil",
  "due_time": "09:00"
}'

const res = await fetch("https://ornek.solk.app/api/v1/tasks/23", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "priority": "Acil",
    "due_time": "09:00"
  }),
});
const data = await res.json();

import os, requests

r = requests.patch(
    "https://ornek.solk.app/api/v1/tasks/23",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    json={
        "priority": "Acil",
        "due_time": "09:00"
    },
)
print(r.json())

Response

{
  "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": "09:00",
    "id": 23,
    "opp": "",
    "opp_id": null,
    "priority": "Acil",
    "result": "",
    "rid": "00TxuMVTniYx44l",
    "source_key": "",
    "state": "soon",
    "status": "Açık",
    "title": "Fiyat listesini gönder"
  }
}

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