# Ticket Cluster — Support Ticket Theme Clustering

> Ticket Cluster — Support Ticket Theme Clustering is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

Groups a batch of support ticket texts into thematic clusters using LLM-based analysis, returning labeled groups with ticket indexes and counts

## Facts

- Endpoint: POST https://x402.agentutility.ai/ticket-cluster?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ticket-cluster-support-ticket-theme-clustering-1746f6f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QJy0HP5aU23Wd-iTKOMPd

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ticket-cluster-support-ticket-theme-clustering-1746f6f2 -d '<json body>'
```

Example prompt: Cluster these 50 support tickets by theme and return up to 10 groups — I want to know which issues are most common so I can triage them: [ticket texts array]

## When to prefer this

Choose this endpoint when you need to automatically organize a batch of unstructured support ticket or feedback texts into meaningful thematic groups without any pre-defined taxonomy. It is especially useful for support ops automation, weekly reporting, triage workflows, or any scenario where you receive a volume of text submissions and want to surface recurring themes. Prefer this over manual tagging or simpler keyword-based grouping when tickets are free-form prose. It supports up to 200 tickets per call and up to 30 clusters, making it suitable for medium-scale batch operations.

## Known failure modes

- Exceeding 200 tickets per call returns a validation error
- Individual tickets over 2,000 characters may be truncated or rejected
- Requesting more than 30 max_clusters returns an error
- Ambiguous or very short tickets may be misclustered into catch-all groups
- LLM unavailability on the Morpheus backend returns a 5xx error
- Empty tickets array returns a validation error

## How this service works

817 pay-per-call APIs for AI agents. Every endpoint is POST /<name> and is payable in USDC over x402 on Base and Solana — no signup, no API key, just pay-per-call. GET https://x402.agentutility.ai/ returns the same catalog as machine-readable JSON.

## Output

Returns a JSON object with the model used, source, total ticket count, cluster count, and an array of clusters each containing a label (e.g. 'login issues'), a sample ticket text, the count of tickets in that cluster, and an array of ticket indexes mapping back to the original input array.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "tickets"
     ],
     "properties": {
      "tickets": {
       "type": "array",
       "description": "1-200 support ticket texts (strings) to cluster by theme. Each ticket max 2,000 chars."
      },
      "max_clusters": {
       "type": "number",
       "description": "Maximum number of clusters to return. Default 8, max 30."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "model": {
       "type": "string"
      },
      "source": {
       "type": "string"
      },
      "clusters": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "count": {
          "type": "integer"
         },
         "label": {
          "type": "string"
         },
         "sample": {
          "type": "string"
         },
         "ticket_indexes": {
          "type": "array",
          "items": {
           "type": "integer"
          }
         }
        }
       }
      },
      "ticket_count": {
       "type": "integer"
      },
      "cluster_count": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "model": "hermes-3-llama-3.1-405b",
  "source": "morpheus",
  "clusters": [
   {
    "count": 2,
    "label": "login issues",
    "sample": "can't log in to my account",
    "ticket_indexes": [
     0,
     2
    ]
   },
   {
    "count": 1,
    "label": "billing",
    "sample": "you charged me twice this month",
    "ticket_indexes": [
     1
    ]
   }
  ],
  "ticket_count": 3,
  "cluster_count": 2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ticket-cluster-support-ticket-theme-clustering-1746f6f2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)