Teams
Teams erstellen und verwalten sowie Mitglieder zuweisen.
Teams gruppieren Nutzer für eine einfachere Board-Zugriffsverwaltung. Wenn ein Team einem Board zugewiesen wird, erhalten alle Teammitglieder automatisch Zugriff.
Teams auflisten
GET /api/v1/teamsQuery-Parameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| page | number | Nein | Seitennummer (Standard: 1) |
| limit | number | Nein | Einträge pro Seite (Standard: 20) |
| search | string | Nein | Nach Team-Name suchen |
Beispiel-Response
{
"data": [
{
"id": "team_abc123",
"name": "Engineering",
"color": "#3B82F6",
"memberCount": 5,
"createdAt": "2025-01-15T10:00:00Z"
}
],
"total": 3,
"page": 1,
"pageSize": 20,
"totalPages": 1
}Team erstellen
POST /api/v1/teamsBerechtigung erforderlich: teams:*
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | string | Ja | Team-Name (max. 100 Zeichen) |
| color | string | Nein | Team-Farbe (Hex-Code, z.B. #3B82F6) |
| memberIds | string[] | Nein | Initiale Mitglieder-Nutzer-IDs |
Beispiel-Request
{
"name": "Engineering",
"color": "#3B82F6",
"memberIds": ["usr_abc123", "usr_def456"]
}Team abrufen
GET /api/v1/teams/{teamId}Gibt ein Team mit seinen Mitgliedern zurück.
Team aktualisieren
PATCH /api/v1/teams/{teamId}Berechtigung erforderlich: teams:*
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | string | Nein | Team-Name |
| color | string | Nein | Team-Farbe |
Team löschen
DELETE /api/v1/teams/{teamId}Berechtigung erforderlich: teams:*
Löscht das Team dauerhaft. Gibt 204 No Content zurück.
Teammitglied hinzufügen
POST /api/v1/teams/{teamId}/membersBerechtigung erforderlich: teams:*
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| userId | string | Ja | Hinzuzufügende Nutzer-ID |
Teammitglied entfernen
DELETE /api/v1/teams/{teamId}/members/{userId}Berechtigung erforderlich: teams:*
Entfernt einen Nutzer aus dem Team. Gibt 204 No Content zurück.