CLclickup
Tasks

Get Task's Time in Status

Changed on

View how long a task has been in each status. The Total time in Status ClickApp must first be enabled by the Workspace owner or an admin.

get/v2/task/{task_id}/time_in_status

Request

  • Base URL
    https://api.clickup.com/api
  • URL
    https://api.clickup.com/api/v2/task/{task_id}/time_in_status
  • Auth
    API key in header Authorization

Path parameters

task_idstring required
Example:9hz

Query parameters

custom_task_idsboolean
Example:true

If you want to reference a task by it's custom task id, this value must be true.

team_idnumber
Example:123

When the custom_task_ids parameter is set to true, the Workspace ID must be provided using the team_id parameter.
For example: custom_task_ids=true&team_id=123.

Headers

Content-Type'application/json' required
Example:application/json

Response

Example response

{
  "current_status": {
    "status": "open",
    "color": "#d3d3d3",
    "total_time": {
      "by_minute": 21708,
      "since": "1604004423494"
    }
  },
  "status_history": [
    {
      "status": "open",
      "color": "#d3d3d3",
      "type": "open",
      "total_time": {
        "by_minute": 21707,
        "since": "1604004423494"
      },
      "orderindex": 0
    },
    {
      "status": "active status",
      "color": "#5CF1D4",
      "type": "custom",
      "total_time": {
        "by_minute": 23274,
        "since": "1602607941692"
      },
      "orderindex": 4
    }
  ]
}

Changes

  • a0a72ec97ddbRevision changes
    • breaking

      the // response's property type changed from no type to object for status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status