Get task counts by assignee

This page documents the canonical HTTP contract for this endpoint.

Body parameters

filter · optional
object
FilterDescriptor with required root RuleNode or GroupNode.
include_skipped · optional
boolean
Include skipped tasks; defaults to false.
include_total_count · optional
boolean
Include total count; defaults to true.
include_research_values · optional
boolean
Include research values; defaults to true.
research_field_ids · optional
array<string>
Research field IDs to include.
pagination · optional
object
Cursor and page limit; limit defaults to 50 and must be at least 1.
scope · optional
string
Legacy task scope selector.
search · optional
string
Task search text.
sort · optional
array<object>
Sort by field and optional direction (asc or desc; default asc).

Name	Type	Description
filter	object	FilterDescriptor with required root RuleNode or GroupNode.
include_skipped	boolean	Include skipped tasks; defaults to false.
include_total_count	boolean	Include total count; defaults to true.
include_research_values	boolean	Include research values; defaults to true.
research_field_ids	array<string>	Research field IDs to include.
pagination	object	Cursor and page limit; limit defaults to 50 and must be at least 1.
scope	string	Legacy task scope selector.
search	string	Task search text.
sort	array<object>	Sort by field and optional direction (asc or desc; default asc).

Definitions

RuleNode

A filter rule uses kind=rule, field and operator, plus value or values as appropriate.

Fields

kind · optional
string
fieldrequired
string
operatorrequired
string
value · optional
any
values · optional
array<any>

Name	Type	Description
kind	string	-
fieldrequired	string	-
operatorrequired	string	-
value	any	-
values	array<any>	-

GroupNode

A group combines child rules using all/any logic.

Fields

kind · optional
string
logicrequired
string
childrenrequired
array<object>

Name	Type	Description
kind	string	-
logicrequired	string	-
childrenrequired	array<object>	-

Errors

Status	Meaning
401	Authentication is missing or invalid.
403	Missing tasks:read.

Example

bash

curl -X POST "https://app.autotouch.ai/api/task-queue/assignee-counts" \
  -H "Authorization: Bearer $AUTOTOUCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filter":{"root":{"kind":"rule","field":"status","operator":"eq","value":"pending"}},"include_skipped":false,"include_total_count":true,"include_research_values":true,"pagination":{"limit":50},"sort":[{"field":"due_at","direction":"asc"}]}'

Request body

json

{
  "filter": {
    "root": {
      "kind": "rule",
      "field": "status",
      "operator": "eq",
      "value": "pending"
    }
  },
  "include_skipped": false,
  "include_total_count": true,
  "include_research_values": true,
  "pagination": {
    "limit": 50
  },
  "sort": [
    {
      "field": "due_at",
      "direction": "asc"
    }
  ]
}

Response example

json

{
  "counts": [
    {
      "user_id": "67c1dc35b4dd8f2d4999ed01",
      "count": 4,
      "overdue_count": 1
    }
  ],
  "total": 4
}