conecto. Get started
HR

Complete or reopen a task

hr_complete_task · Changes data · Markdown

Marks a checklist task done, or opens it again.

$0.01 a call

From your agent’s balance. A call that fails costs nothing.

An example

Lena handed Felix his warehouse keys. Tick that off.

Your agent callshr_complete_task$0.01 a call

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "task_id": 4171
}
What comes back
{
  "task": {
    "task_id": 4171,
    "title": "Sign the contract and send the tax ID",
    "person": {
      "person_id": 4105,
      "name": "Felix Wagner"
    },
    "owner": "person",
    "owner_person": {
      "person_id": 4105,
      "name": "Felix Wagner",
      "work_email": "felix.wagner@hansenvoss.example"
    },
    "checklist": "Warehouse onboarding",
    "kind": "onboarding",
    "due_date": "2026-10-30",
    "overdue": false,
    "done": true,
    "done_at": "2026-10-14T08:00:00+00:00",
    "done_by": "Pip"
  }
}

Use it when

Someone did a task on the list.

What it does

Mark a checklist task done, or open it again with done: false.

What comes back

task: the task with its new state. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
task_idRequiredintegerAt least 1.
donebooleanDefault: true.

The call

Over MCP, call hr_complete_task on https://api.conecto.chat/mcp/hr. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/hr_complete_task \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task_id":4171}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_found404No task has that task_id.Find it with hr_tasks.
already_done409The task is done already.Nothing to do.
not_done409The task is still open.Nothing to reopen.

More HR tools

All 23 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md