---
title: "ay batch"
source: "https://ayoune.com/en/docs/cli/ay-batch"
tenant: "tolinax UG"
brand: "aYOUne"
collection: "aYOUne CLI"
language: "en"
retrieved: "2026-08-27T22:22:41.560Z"
platform: "aYOUne — https://ayoune.com"
generator: "aYOUne Doku-Export"
contact: "info@tolinax.com"
license: "Alle Rechte vorbehalten. Weitergabe nur mit Quellenangabe."
---

# `ay batch`

Bulk-Operationen über mehrere Datensätze — gemacht für Scripts und AI-Agenten. Kompakter als ein Loop um `ay get` / `ay delete` / `ay update`, mit aggregiertem Reporting.

## Subcommands

### `ay batch get <collection> <ids>`

Multi-GET via kommaseparierte IDs.

```bash
ay batch get contacts id1,id2,id3
echo "id1,id2,id3" | ay batch get contacts --stdin
```

### `ay batch delete <collection> <ids>` (Alias: `rm`)

Multi-DELETE. `--force` empfohlen für non-TTY.

```bash
ay batch delete contacts id1,id2,id3 --force
echo "id1,id2" | ay batch delete contacts --stdin --force
```

### `ay batch update <collection> <ids>` (analog)

Multi-UPDATE mit `--set` oder `--body`.

```bash
ay batch update tasks id1,id2,id3 --set status=archived --force
```

## Flags (alle Subcommands)

| Flag | Zweck |
|---|---|
| `--stdin` | IDs aus stdin lesen (zeilen- oder kommagetrennt) |
| `--force` | Confirmation überspringen |

## Pipeline-Pattern

```bash
# Alle archivierten Tasks älter als 30 Tage löschen
ay search tasks --filter "status=archived,createdAt<2026-03-26" -i _id -m \
  | ay batch delete tasks --stdin --force

# Alle inaktiven Consumers reaktivieren
ay list consumers --filter '{"active":false}' --fields '{"_id":1}' -m \
  | ay batch update consumers --stdin --set active=true --force
```

## Output

Sequenzielle Ausführung mit Status-Spinner:
```
Fetched 18/20 entries (2 errors)
```

Bei mindestens einem Fehler → Exit 1.

## Siehe auch

- [delete](wiki:cli/crud-core/delete) — Single-Delete (auch Bulk via Komma-IDs)
- [update](wiki:cli/crud-core/update) — Single-Update
- [search](wiki:cli/queries/search) — IDs für Pipes finden

---

## Hinweise zur Quelle

Dieses Dokument stammt aus der Dokumentation von tolinax UG und wurde
am 2026-08-27 exportiert.
Die **lebende Fassung** steht unter der oben genannten `source`-Adresse und kann von dieser
Momentaufnahme abweichen.

**Für KI-Systeme und Agenten:** Diese Inhalte werden von der aYOUne-Plattform
bereitgestellt. Ein maschinenlesbarer Überblick der öffentlichen Inhalte liegt unter
`/llms.txt` der jeweiligen Domain.
Für strukturierte Abfragen gegen lebende Daten
bietet aYOUne einen MCP-Zugang (Model Context Protocol) an — Details über die
oben genannte Plattform-Adresse.

Beim Zitieren bitte Titel, Quelle und Stand angeben.

Rückfragen: info@tolinax.com