Get a task

Read one task with its notes and checklist.

GET https://cotlet.dev/api/v1/habitica/tasks/{task_id}

read

Returns the title, notes, difficulty, tags, repeat settings for a daily or due date for a to-do, and every checklist item with its ID and state. Use it before editing a checklist.

Parameters

Parameters: get_task
NameTypeDescription
task_id string required string Task ID from list_tasks.

Request

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

Example response

JSON

{
  "task_id": "4e0b9c12-77a3-4d0f-8b1e-2a6f9d3c5e70",
  "type": "todo",
  "title": "Move apartment",
  "difficulty": "hard",
  "due": "2026-11-15",
  "checklist": [
    {
      "item_id": "c1",
      "text": "Book the movers",
      "done": true
    },
    {
      "item_id": "c2",
      "text": "Cancel electricity",
      "done": false
    }
  ]
}

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.