Task Rollups

Dashboard aggregation over the task collection: count / points / creatives / avg complexity / return count, grouped by any combination of status, product, work_stream, task_type and assignee. Not a new data model — a GROUP BY/SUM over fields Task already has, e.g. group_by=assignee,status for the weekly-workload breakdown by stage.

GET/api/v1/tasks/rollups

Authorization

AuthorizationBearer token · headerrequired

AuthorizationOAuth2 access token · headerrequired

Query parameters

date_fromstring<date-time> | any

date_tostring<date-time> | any

date_fieldstring

default: "completed_at"

Allowed:completed_atcreated_at

group_bystring[]

time_bucketstring | any

status_inTaskStatus[]

productstring[]

work_streamWorkStream[]

task_typeTaskType[]

assigneestring[]

sourceSource[]

teamstring[]

Responses

200Successful Response

successboolean

default: true

dataRollupsResult | any

Show properties

Any of:

RollupsResult

rowsRollupRow[]required

Show properties

Array of RollupRow

group_keyobjectrequired

countintegerrequired

sum_creation_pointsnumberrequired

sum_execution_pointsnumberrequired

sum_creativesintegerrequired

avg_creation_complexitynumber | anyrequired

Show properties

Any of:

number

number

any

any

avg_execution_complexitynumber | anyrequired

Show properties

Any of:

number

number

any

any

return_countintegerrequired

avg_time_in_progress_secondsnumber | anyrequired

Show properties

Any of:

number

number

any

any

avg_time_on_check_secondsnumber | anyrequired

Show properties

Any of:

number

number

any

any

any

any

messagestring | any

Show properties

Any of:

string

string

any

any

errorsstring[] | any

Show properties

Any of:

string[]

Array of string

string

any

any

422Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

Request

curl -X GET "/api/v1/tasks/rollups" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("/api/v1/tasks/rollups", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "/api/v1/tasks/rollups",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "success": true,
  "data": {
    "rows": [
      {
        "group_key": {
          "property1": "string",
          "property2": "string"
        },
        "count": 0,
        "sum_creation_points": 0,
        "sum_execution_points": 0,
        "sum_creatives": 0,
        "avg_creation_complexity": 0,
        "avg_execution_complexity": 0,
        "return_count": 0,
        "avg_time_in_progress_seconds": 0,
        "avg_time_on_check_seconds": 0
      }
    ]
  },
  "message": "string",
  "errors": [
    "string"
  ]
}