Projects
Delete a task
Deletes a task and its subtasks for good.
Free
This tool costs nothing to call.
An example
Delete SALE-5. We're not doing the radio ad after all.
Your agent callstasks_deleteFree
The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.
With these arguments
{
"task": "SALE-5"
}What comes back
Use it when
A task was a mistake or will never happen. To keep it, move it to Canceled instead.
What it does
Delete a task and its subtasks for good.
What comes back
deleted: the task's number. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
taskRequired | string | A task like "WEB-12", or its task_id. 1 to 20 characters. |
The call
Over MCP, call tasks_delete on https://api.conecto.chat/mcp/projects. Over REST:
Terminal
curl -X POST https://api.conecto.chat/v1/tools/tasks_delete \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"task":"SALE-5"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No task has that number or task_id. | Find it with tasks_list. |
More Projects tools
All 9 tools- Create a project
projects_createCreates a board of tasks with a short key that numbers them, and its own statuses if you like.$0.001 a call - List projects
projects_listEvery project with how many tasks are in each status.Free* - See a project's board
projects_boardA project as a board: each status with its tasks in order.Free* - Create a task
tasks_createAdds a task to a project, numbered like SALE-13, with status, priority, assignee, labels, due date, CRM links or a parent.$0.01 a call - Change a task
tasks_updateChanges a task: status, assignee, priority, labels, due date, title, description, CRM links or its place in the column.$0.01 a call - Find tasks
tasks_listOpen tasks across projects or in one, most urgent first, filtered by status, assignee, label, priority, due date or words.Free* - Get a task
tasks_getOne task in full: description, links, subtasks, comments and history.Free* - Comment on a task
tasks_commentAdds a comment in Markdown to a task's thread.$0.01 a call
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md