Update a record
Change fields of one record, for example Status, Sales Stage or Next Step.
PATCH https://cotlet.dev/api/v1/suitecrm/records/{record_id}
write
Changes only the fields you pass and returns the record afterwards. It does not message anyone itself, but workflows your admin set up in SuiteCRM still run on the change. It is undone by changing the field back, so it does not wait for your OK.
Parameters
| Name | Type | Description |
|---|---|---|
| module string required | string | Module: Leads, Contacts, Accounts, Opportunities, Cases, Tasks, Calls, Meetings or Notes. |
| record_id string required | string | Record ID from list_records. |
| fields object required | object | Field names and new values as in the record's Edit View, for example {"status": "Dead"}. |
Request
curl -X PATCH https://cotlet.dev/api/v1/suitecrm/records/record_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"module":"module","fields":"fields"}'result = client.call("suitecrm", "update_record", {"module":"module","record_id":"record_8c41d2","fields":"fields"})const result = await cotlet.call('suitecrm', 'update_record', {"module":"module","record_id":"record_8c41d2","fields":"fields"});cotlet call suitecrm update_record --data '{"module":"module","record_id":"record_8c41d2","fields":"fields"}'Example response
{
"module": "Leads",
"record_id": "e91d3a77-0c5b-4d28-b6f1-7a2c8e4d9013",
"changed": {
"status": "Dead"
},
"updated_at": "2026-10-23T09:12:00"
}