Count tasks - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

Body parameters

filter · optional
object
FilterDescriptor tree.
search · optional
string
Optional free-text search.
scope · optional
string
Legacy org or user scope toggle; prefer a descriptor rule on field scope.
pagination · optional
object
Accepted by the shared query request model; ignored by count calculation.
sort · optional
array<object>
Accepted by shared query model; count is independent of ordering.
include_skipped · optional
boolean
Include skipped tasks in count. Defaults to false.
include_total_count · optional
boolean
Accepted by shared model but ignored by count endpoint.
include_research_values · optional
boolean
Accepted by shared model but ignored by count endpoint.
research_field_ids · optional
array<string>
Accepted by shared model but ignored by count endpoint.

Name	Type	Description
filter	object	FilterDescriptor tree.
search	string	Optional free-text search.
scope	string	Legacy org or user scope toggle; prefer a descriptor rule on field scope.
pagination	object	Accepted by the shared query request model; ignored by count calculation.
sort	array<object>	Accepted by shared query model; count is independent of ordering.
include_skipped	boolean	Include skipped tasks in count. Defaults to false.
include_total_count	boolean	Accepted by shared model but ignored by count endpoint.
include_research_values	boolean	Accepted by shared model but ignored by count endpoint.
research_field_ids	array<string>	Accepted by shared model but ignored by count endpoint.

Errors

Status	Meaning
400	Invalid descriptor payload.
401	Invalid API key or missing auth.
403	Missing tasks:read scope.

Example

bash

curl -X POST "https://app.autotouch.ai/api/task-queue/query/count" \
    -H "Authorization: Bearer stk_your_key_id.your_secret" \
    -H "Content-Type: application/json" \
    -d '{"filter":{"root":{"kind":"rule","field":"task_status","operator":"eq","value":"pending"}}}'

Request body

json

{
    "filter": {
      "root": {
        "kind": "rule",
        "field": "task_status",
        "operator": "eq",
        "value": "pending"
      }
    }
  }

Response example

json

{
    "count": 42
  }