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

# `ay exec` (Alias: `x`)

Führt eine registrierte API-Action aus, identifiziert über `operationId`. Ruft die `apiactions`-Registry des Servers ab, um die Action-Definition (Host, Endpoint, Method, Params) aufzulösen, dann der eigentliche HTTP-Call mit dem User-Token.

## Syntax

```
ay exec <operationId> [args] [flags]
```

## Beispiele

```bash
# Custom-Action für einen Consumer
ay exec sendWelcomeMail --param consumerId=64a1b2c3

# AI-Generate-Aufruf
ay exec aiGenerate --param prompt="Schreibe eine Willkommens-Email"

# Action ohne Args
ay exec recomputeKpis

# Body via JSON
ay x publishCampaign --body '{"campaignId":"64a1...","scheduledAt":"2026-05-01T10:00:00Z"}'
```

## Auflösungs-Reihenfolge

1. CLI fragt `config-api/apiactions?q=<operationId>` (für non-Admin User).
2. Bei 401/403 → Fallback auf `su/apiactions` (Superuser-Path).
3. Exact-Match auf `operationId`, sonst Partial-Match (erster Treffer).
4. Bei keinem Treffer → Exit 1; bei nur 403 in beiden Modulen → Exit 5.

## Hinweis

Custom-Actions liegen unter `/<collection>/:id/actions/<action-name>`. Sub-Resource-GETs (z.B. `/:id/logs`) sind keine Actions — diese laufen via [describe](wiki:cli/crud-core/describe) `<collection> <id> <subResource>`.

## Siehe auch

- [actions](wiki:cli/utilities/actions) — Action-Discovery
- [curl](wiki:cli/misc/curl) — Direkter HTTP-Call

---

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