v1

latestOpenAPI 3.1.02026-07-24172151607.6 KB
Tasks

Get Bulk Tasks' Time in Status

View how long two or more tasks have been in each status. The Total time in Status ClickApp must first be enabled by the Workspace owner or an admin.

get/v2/task/bulk_time_in_status/task_ids

Query parameters

task_idsstring required

Include this paramater once per task_id. You can include up to 100 task ids per request. For example: task_ids=3cuh&task_ids=g4fs

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

{
  "27075wz": {
    "current_status": {
      "status": "open",
      "color": "#d3d3d3",
      "total_time": {
        "by_minute": 21830,
        "since": "1604004423494"
      }
    },
    "status_history": [
      {
        "status": "open",
        "color": "#d3d3d3",
        "type": "open",
        "total_time": {
          "by_minute": 21829,
          "since": "1604004423494"
        },
        "orderindex": 0
      },
      {
        "status": "active status #2",
        "color": "#5CF1D4",
        "type": "custom",
        "total_time": {
          "by_minute": 23274,
          "since": "1602607941692"
        },
        "orderindex": 4
      }
    ]
  },
  "20bbn28": {
    "current_status": {
      "status": "open",
      "color": "#d3d3d3",
      "total_time": {
        "by_minute": 21830,
        "since": "1604004420925"
      }
    },
    "status_history": [
      {
        "status": "open",
        "color": "#d3d3d3",
        "type": "open",
        "total_time": {
          "by_minute": 22276,
          "since": "1604004420925"
        },
        "orderindex": 0
      },
      {
        "status": "active status #2",
        "color": "#5CF1D4",
        "type": "custom",
        "total_time": {
          "by_minute": 40109,
          "since": "1601597828835"
        },
        "orderindex": 4
      }
    ]
  }
}