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

# `ay users`

Verwaltet User, Teams und Roles. Routes via `su`-Modul zum Legacy-API.

## Subcommands

### `ay users list` (Alias: `ls`)

| Flag | Zweck |
|---|---|
| `--search <q>` | Search nach Name oder Email |
| `--role <roleId>` | Filter auf Role |
| `--active` | Nur aktive User |

```bash
ay users list
ay users list --search max
ay users list --role 64a1b2c3 --active
```

### `ay users get <id>`

```bash
ay users get 64a1b2c3
```

### `ay users invite`

Lädt einen neuen User ein (Email mit Setup-Link).

| Flag | Pflicht | Zweck |
|---|---|---|
| `--email <email>` | ja | Email des Eingeladenen |
| `--role <roleId>` | nein | Role zuweisen |
| `--firstName <name>` | nein | Vorname |
| `--lastName <name>` | nein | Nachname |

```bash
ay users invite --email max@example.com --role 64a1... --firstName Max
```

### `ay users update <id>`

```bash
ay users update 64a1b2c3 --set role=64b2... --set active=true
```

### `ay users delete <id>`

```bash
ay users delete 64a1b2c3
```

### `ay users teams list` / `ay users teams get <id>`

```bash
ay users teams list
ay users teams get 64a1b2c3
```

### `ay users roles list` / `ay users roles get <id>`

```bash
ay users roles list
ay users roles get 64a1b2c3
```

## Hinweis

Effective rights = `user.role.rights ∪ user.customRights.rights ∩ customer.packages[].package.modules ∪ customer.customRights[].right`. Packages sind **additiv** — eine restriktive Package kann Rights nicht entziehen, sondern nur hinzufügen.

## Siehe auch

- [permissions](wiki:cli/misc/permissions) — Permission-Requests
- [access](wiki:cli/auth-config/access) — Was darf der aktuelle User?

---

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