Assign a service record
Assign a record to an agent, a group, or both.
POST https://cotlet.dev/api/v1/sysaid/records/{record_id}/service-record/assign
write Confirm
Returns the assignee and group after the change. Pass whichever your account uses; passing neither fails. The new assignee gets the instant message SysAid sends when a record is assigned to them, and the assignment appears in the Journey highlights. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| record_id integer required | integer | Service record ID from search_service_records. IDs are unique across incidents, requests, problems and changes. |
| assignee string | string | Agent name from list_agents_and_groups. |
| group string | string | Group name from list_agents_and_groups. |
Request
curl -X POST https://cotlet.dev/api/v1/sysaid/records/1/service-record/assign \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("sysaid", "assign_service_record", {"record_id":1})const result = await cotlet.call('sysaid', 'assign_service_record', {"record_id":1});cotlet call sysaid assign_service_record --data '{"record_id":1}'Example response
{
"id": 48230,
"assignee": "Jordan Reyes",
"group": "Network",
"assigned_count": 1,
"modified_at": "2026-10-23T08:42:00Z"
}