Close a task

Mark a task as done, like Close in the Actions menu.

POST https://cotlet.dev/api/v1/suitecrm/tasks/{task_id}/close

write

Runs Close from the task's Actions drop-down; the task moves to the History tile of its record. It reaches no one and can be reopened by update_record, so it does not wait for your OK.

Parameters

Parameters: close_task
NameTypeDescription
task_id string required string Task ID from list_records.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/suitecrm/tasks/task_8c41d2/close \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("suitecrm", "close_task", {"task_id":"task_8c41d2"})
Node.js
const result = await cotlet.call('suitecrm', 'close_task', {"task_id":"task_8c41d2"});
CLI
cotlet call suitecrm close_task --data '{"task_id":"task_8c41d2"}'

Example response

JSON

{
  "task_id": "b6f3a290-1d84-4c7e-8e5a-2f9d0c71a4b3",
  "status": "Completed",
  "closed_at": "2026-10-23T09:40:00"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.