clickup_get_task_time_in_status
Read-onlyIdempotent
Retrieve the amount of time a task has spent in each status. Use for cycle-time and workflow analysis on individual tasks.
Instructions
Report how long one task has spent in each status.
Calls GET /task/{task_id}/time_in_status. Requires the 'Total time in
Status' ClickApp to be enabled. Set custom_task_ids=true (+ team_id) to
address the task by Custom Task ID.
When to Use:
Cycle-time / workflow analysis for a single task.
When NOT to Use:
For many tasks at once — use
clickup_get_bulk_tasks_time_in_status.
Returns:
Markdown (current status + per-status history in Xh Ym) or raw JSON.
Examples:
params = {"task_id": "86cxy1"}
Error Handling: An empty result usually means the ClickApp is disabled; 404 means a bad id.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |