Score a habit or tick a daily

Tick a daily or to-do, or score a habit up or down.

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

write

Applies the same result as clicking the task in Habitica and returns the new streak or completion state. Scoring up on a habit counts toward your rewards. It changes only your own account and a second call reverses it, so it does not ask for OK by default.

Parameters

Parameters: score_task
NameTypeDescription
task_id string required string Task ID from list_tasks.
direction string required string One of: up, down. A daily or to-do uses up to tick it and down to untick it.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/habitica/tasks/b7c1f6a0-3d52-4e1a-9a7e-5d1c0f2e8a11/score \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"direction":"up"}'
Python
result = client.call("habitica", "score_task", {"task_id":"b7c1f6a0-3d52-4e1a-9a7e-5d1c0f2e8a11","direction":"up"})
Node.js
const result = await cotlet.call('habitica', 'score_task', {"task_id":"b7c1f6a0-3d52-4e1a-9a7e-5d1c0f2e8a11","direction":"up"});
CLI
cotlet call habitica score_task --data '{"task_id":"b7c1f6a0-3d52-4e1a-9a7e-5d1c0f2e8a11","direction":"up"}'

Example response

JSON

{
  "task_id": "b7c1f6a0-3d52-4e1a-9a7e-5d1c0f2e8a11",
  "direction": "up",
  "completed": true,
  "streak": 13
}

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.