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

# `ay curl`

Authentifizierter HTTP-Call gegen einen aYOUne-API-Endpoint — wie `curl`, aber mit dem aktuellen JWT als Bearer-Token. Fürs Debuggen, ad-hoc Custom-Endpoints und Test-Invocations.

## Syntax

```
ay curl <module> <path> [flags]
```

`<module>` ist der Module-Slug (z.B. `crm`, `config`, `ai`). Daraus wird `https://<module>-api.ayoune.app` gebaut. Spezial-Module (`auth`, `aggregation`, `logs`) gehen auf ihre dedizierten Hosts.

## Flags

| Flag | Default | Zweck |
|---|---|---|
| `-X, --method <verb>` | `get` | `get` / `post` / `put` / `delete` / `patch` |
| `--body <json>` | — | Inline-JSON-Body |
| `--body-file <path>` | — | Body aus Datei |
| `--body-stdin` | — | Body aus stdin |
| `--query <kv...>` | — | Query-Param `key=value` (wiederholbar) |
| `--raw` | false | Response unverändert ausgeben (für NDJSON-Streams) |

Body-Reihenfolge: `--body-stdin` > `--body-file` > `--body`.

## Beispiele

```bash
# Simpler GET
ay curl crm consumers

# Mit Query-Params
ay curl pm tasks --query limit=5 --query status=open

# POST mit Body
ay curl config flags/64a1b2c3 -X put --body '{"archived":true}'

# Body aus stdin (z.B. von jq)
echo '{"prompt":"Hallo Welt"}' | ay curl ai ai/ask -X post --body-stdin

# NDJSON-Stream durchreichen
ay curl monitoring logs/stream --raw

# Custom-Action
ay curl crm "consumers/64a1b2c3/actions/send-welcome" -X post
```

## Hinweis

`ay curl` ist absichtlich dünn — kein Auto-Pagination, keine Format-Conversion. Für strukturierte Outputs → die dedizierten Commands ([list](wiki:cli/crud-core/list), [search](wiki:cli/queries/search), [exec](wiki:cli/utilities/exec)).

## Siehe auch

- [exec](wiki:cli/utilities/exec) — Action via `operationId`
- [actions](wiki:cli/utilities/actions) — Action-Discovery
- [services endpoints](wiki:cli/auth-config/services) — Endpoint-Discovery

---

## 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