People

Update a person

Only the fields you send change. is_former: true marks the person as left (not deleted); is_main: true makes them the main contact.

PATCH/api/v1/contacts/{id}

Authorization

Authorizationheaderrequired

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

Module: CustomersScope: crm.write

Path parameters

idintegerrequired

Person id.

Body application/json

name / title / department / phone / email / notestringoptional

Text fields.

is_mainbooleanoptional

Make main contact.

is_formerbooleanoptional

Left the company.

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/contacts/59 \
  -H "Authorization: Bearer $SOLK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Fabrika Müdürü",
  "is_main": true
}'

const res = await fetch("https://ornek.solk.app/api/v1/contacts/59", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "title": "Fabrika Müdürü",
    "is_main": true
  }),
});
const data = await res.json();

import os, requests

r = requests.patch(
    "https://ornek.solk.app/api/v1/contacts/59",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    json={
        "title": "Fabrika Müdürü",
        "is_main": True
    },
)
print(r.json())

Response

{
  "contact": {
    "customer": "Kuzey Plastik Sanayi",
    "customer_id": 31,
    "department": "Üretim",
    "email": "emre.yildiz@kuzeyplastik.com.tr",
    "id": 59,
    "is_former": false,
    "is_main": true,
    "name": "Emre Yıldız",
    "note": "",
    "phone": "+90 532 555 11 22",
    "rid": "0037CJrFvjDFvYX",
    "title": "Fabrika Müdürü",
    "wa": "905325551122"
  },
  "ok": true
}

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