# SignalDesk AI Array Group-By

> SignalDesk AI Array Group-By is a paid API for AI agents from x402-agent.kariguetoazul.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-13).

Groups a JSON array of objects by a specified field name, returning partitioned groups with their matching items.

## Facts

- Endpoint: POST https://x402-agent.kariguetoazul.workers.dev/api/json/array-group-by?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/signaldesk-ai-array-group-by-d37e00bf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ok7pJjhUXPS9_9jgVVYnq

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 signaldesk-ai-array-group-by-d37e00bf -d '<json body>'
```

Example prompt: Can you group this array of sales records by the 'region' field: [{"region":"north","amount":100},{"region":"south","amount":200},{"region":"north","amount":150}]?

## When to prefer this

Choose this endpoint when you need a simple, paid, on-demand group-by operation on a JSON array without setting up server-side infrastructure. Ideal for agents that need to partition up to 1000 records by a single field key in real time as part of an automated workflow, especially when integrated with x402 micropayment flows on Cloudflare Workers.

## Known failure modes

- Missing or empty 'key' field returns an error or ungrouped result
- Array items that lack the specified key field may be grouped under an undefined/null bucket
- Arrays exceeding 1000 items are rejected due to maxItems constraint
- Malformed JSON in the values array causes a parsing error
- Payment failure (402) if USDC balance is insufficient for the $0.001 per-call fee

## How this service works

Evidence-backed autonomous AI jobs and paid data tools. Queue/D1/cron run outside the chat; free quotas and bounded execution apply.

## Output

Returns a JSON object containing a 'groups' array, where each element has a 'key' (the distinct value of the grouped field) and an 'items' array listing all original objects that share that key value.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "key": {
   "type": "string",
   "maxLength": 128,
   "description": "Field name."
  },
  "values": {
   "type": "array",
   "items": {},
   "maxItems": 1000,
   "minItems": 0,
   "description": "JSON array."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "groups": [
   {
    "key": "a",
    "items": [
     {
      "n": 1,
      "kind": "a"
     },
     {
      "n": 2,
      "kind": "a"
     }
    ]
   },
   {
    "key": "b",
    "items": [
     {
      "n": 3,
      "kind": "b"
     }
    ]
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/signaldesk-ai-array-group-by-d37e00bf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent.kariguetoazul.workers.dev](https://www.zero.xyz/host/x402-agent.kariguetoazul.workers.dev/llms.txt)