Change a task

tasks_update · Changes data · Markdown

Changes a task: status, assignee, priority, labels, due date, title, description, CRM links or its place in the column.

$0.01 a call

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

The bike photos are done. Move SALE-3 to Done.

Your agent callstasks_update$0.01 a call

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-3",
  "status": "Done"
}

What comes back

{
  "task": {
    "task": "SALE-3",
    "task_id": 4103,
    "title": "Photograph the Tabor in sage",
    "status": "Done",
    "priority": "high",
    "assignee": "luis@halversoncycle.example",
    "labels": [
      "photos"
    ],
    "due_date": "2026-10-16",
    "parent": null,
    "updated_at": "2026-10-14T08:00:00+00:00",
    "description": "",
    "created_by": "Pip",
    "created_at": "2026-10-14T08:00:00+00:00",
    "completed_at": "2026-10-14T08:00:00+00:00",
    "links": {},
    "subtasks": [],
    "comments": [],
    "history": [
      {
        "author": "Pip",
        "change": "Status: To do → Done",
        "at": "2026-10-14T08:00:00+00:00"
      }
    ]
  }
}

Use it when

Work moved on, changed hands or changed priority.

What it does

Change a task: move it to another status, reassign, reprioritize, relabel, set a due date, edit its title or description, or link CRM records. Give only what changes; order "top" puts it first in its column.

What comes back

task: the task in full, as it now is. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`task`Required	string	A task like "WEB-12", or its task_id. 1 to 20 characters.
`title`	string	1 to 200 characters.
`description`	string	Markdown. Up to 20,000 characters.
`status`	string	One of the project's statuses, e.g. "In progress". Up to 40 characters.
`priority`	string	One of: none,low,medium,high,urgent.
`assignee`	string	A bot's name or a person's email; "" to clear. Up to 120 characters.
`labels`	array of strings	Up to 10 items.
`due_date`	string or null	YYYY-MM-DD, or null. Matches ^\d{4}-\d{2}-\d{2}$.
`contact_id`	integer or null
`company_id`	integer or null
`deal_id`	integer or null
`order`	string	One of: top,bottom.

The call

Over MCP, call tasks_update on https://api.conecto.chat/mcp/projects. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/tasks_update \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task":"SALE-3","status":"Done"}'

When it refuses

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

Code	When	What to do
`not_found`404	No task has that number or task_id.	Find it with tasks_list.
`invalid_input`400	The status is not one of the project's, a date is not real, or a subtask's parent is in another project.	Use a status the message lists and dates like 2026-10-16.
`not_found`404	A CRM contact, company or deal id is not the business's.	Find it with crm_search.

More Projects tools

All 9 tools

Give this to your agent.

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

Change a task

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Projects tools

Give this to your agent.