Projects

Get a task

tasks_get · Reads only · Markdown

One task in full: description, links, subtasks, comments and history.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

What's the latest on SALE-2, the flyer?

Your agent callstasks_getFree*

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-2"
}
What comes back
{
  "task": {
    "task": "SALE-2",
    "task_id": 4102,
    "title": "Design the sale flyer",
    "status": "To do",
    "priority": "high",
    "assignee": "luis@halversoncycle.example",
    "labels": [
      "print"
    ],
    "due_date": "2026-10-19",
    "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": null,
    "links": {},
    "subtasks": [],
    "comments": [
      {
        "author": "Pip",
        "body": "The printer needs the final PDF by Thursday at 12:00.",
        "at": "2026-10-14T08:00:00+00:00"
      }
    ],
    "history": []
  }
}

Use it when

Before working on a task, or when someone asks about it.

What comes back

task: the task in full, with its description, links, subtasks, comments and history. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
taskRequiredstringA task like "WEB-12", or its task_id. 1 to 20 characters.

The call

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

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

When it refuses

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

CodeWhenWhat to do
not_found404No task has that number or task_id.Find it with tasks_list.

Give this to your agent.

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