🚀 Jetzt neu: FlowAI! Ein revolutionärer Chat mit personalisierten AI-Agenten. 🌟

Team Management API - für flexible Teamverwaltung

Eine vollständige REST API zur programmgesteuerten Verwaltung von Teammitgliedern, Einladungen, Modul-Berechtigungen und Lizenzen. Perfekt für Enterprise-Anwendungen und automatisierte Team-Workflows.

🚀 Schnellstart

Basis-URL: https://creativeskyline.de/api/team https://creativeskyline.de/api/team/members https://creativeskyline.de/api/team/invitations https://creativeskyline.de/api/team/licenses
Nur Teaminhaber können administrative Aktionen ausführen
Mitglieder hinzufügen, Berechtigungen ändern und Einladungen versenden sind ausschließlich dem Teaminhaber vorbehalten.

1. API-Zugangsdaten abrufen

Bevor Sie die Team Management API nutzen können, benötigen Sie Ihre persönlichen Zugangsdaten: Melden Sie sich an, navigieren Sie zu Profil → API-Zugang und kopieren Sie Ihren persönlichen API-Key (pk_...).

2. Authentifizierung

Alle API-Anfragen benötigen diesen HTTP-Header:

Authorization: Bearer pk_dein_api_key
Accept: application/json

ℹ️ Team-Informationen

Basis-URL: https://creativeskyline.de/api/team https://creativeskyline.de/api/team/members https://creativeskyline.de/api/team/invitations https://creativeskyline.de/api/team/licenses

Team-Informationen abrufen

GET /api/team

Ruft allgemeine Informationen über das Team ab, inklusive Abonnement-Status, Mitgliederzahl und Lizenzübersicht.

Beispiel-Response:

{"success": true, "data": {"team": {"uuid": "550e8400-...", "name": "Mein Unternehmen"}, "owner": {"id": 1, "name": "Max Mustermann", "email": "max@example.com"}, "member_count": 5, "subscription": {"status": "active", "plan": "Business"}, "licenses": {"ai": {"limit": 5, "used": 3}, "tt": {"limit": 10, "used": 7}}}}

👥 Mitglieder-Verwaltung

Basis-URL: https://creativeskyline.de/api/team https://creativeskyline.de/api/team/members https://creativeskyline.de/api/team/invitations https://creativeskyline.de/api/team/licenses
Lizenz-Prüfung
Die Berechtigungen werden automatisch gegen die verfügbaren Lizenzen geprüft. Wenn keine Lizenzen mehr verfügbar sind, wird die Anfrage mit einem 403-Fehler abgelehnt.

Mitglieder auflisten

GET /api/team/members

Listet alle Teammitglieder mit ihren Modul-Berechtigungen auf.

Beispiel-Response:

{"success": true, "data": [{"id": 1, "user_id": 123, "name": "Max Mustermann", "email": "max@example.com", "role": "owner", "permissions": {"ai": true, "tt": true, "td": true, "cm": true, "cc": true, "fs": true, "sa": true}, "joined_at": "2024-01-15T10:00:00Z"}]}

Mitglied-Details abrufen

GET /api/team/members/{userUuid}

Ruft Details eines einzelnen Teammitglieds ab.

Mitglied hinzufügen

POST /api/team/members

Fügt einen bestehenden Benutzer zum Team hinzu (nur Teaminhaber). Die Berechtigungen werden gegen die verfügbaren Lizenzen geprüft.

Request Body:

user_id integer * ID des hinzuzufügenden Benutzers
permissions object * Modul-Berechtigungen (flowai, flowtime, flowtasks, flowcrm, flowcall, flowsend, flowsaas)

Berechtigungen aktualisieren

PUT /api/team/members/{userUuid}

Aktualisiert die Modul-Berechtigungen eines Teammitglieds (nur Teaminhaber).

Request Body:

permissions object * Modul-Berechtigungen (flowai, flowtime, flowtasks, flowcrm, flowcall, flowsend, flowsaas)

Mitglied entfernen

DELETE /api/team/members/{userUuid}

Entfernt ein Mitglied aus dem Team (nur Teaminhaber).

📧 Einladungen

Basis-URL: https://creativeskyline.de/api/team https://creativeskyline.de/api/team/members https://creativeskyline.de/api/team/invitations https://creativeskyline.de/api/team/licenses

Ausstehende Einladungen auflisten

GET /api/team/invitations

Listet alle ausstehenden Einladungen auf (nur Teaminhaber).

Einladung versenden

POST /api/team/members/invite

Sendet eine Einladung an eine E-Mail-Adresse (nur Teaminhaber). Die eingeladene Person erhält eine E-Mail mit einem Einladungslink.

Request Body:

email string * E-Mail-Adresse des einzuladenden Mitarbeiters
permissions object * Modul-Berechtigungen (flowai, flowtime, flowtasks, flowcrm, flowcall, flowsend, flowsaas)

Beispiel-Response:

{"success": true, "message": "Einladung erfolgreich gesendet", "data": {"uuid": "550e8400-...", "email": "neuer.mitarbeiter@example.com", "created_at": "2024-01-15T10:00:00Z"}}

Einladung widerrufen

DELETE /api/team/invitations/{invitationUuid}

Widerruft eine ausstehende Einladung (nur Teaminhaber).

🔐 Unterberechtigungen

Basis-URL: https://creativeskyline.de/api/team https://creativeskyline.de/api/team/members https://creativeskyline.de/api/team/invitations https://creativeskyline.de/api/team/licenses
Unterberechtigung-Typen
Verfügbare Schlüssel: berichte (eigene Berichte), teamberichte (Team-Berichte), projekte (Projektverwaltung), protokolle (Aktivitätsprotokolle).

Unterberechtigungen abrufen

GET /api/team/members/{userUuid}/sub-access

Ruft die Unterberechtigungen eines Mitglieds ab.

Beispiel-Response:

{"success": true, "data": {"berichte": true, "teamberichte": false, "projekte": true, "protokolle": true}}

Unterberechtigungen aktualisieren

PUT /api/team/members/{userUuid}/sub-access

Aktualisiert die Unterberechtigungen eines Mitglieds (nur Teaminhaber).

Request Body:

berichte boolean Zugriff auf eigene Berichte und Statistiken
teamberichte boolean Zugriff auf Team-Berichte und Statistiken
projekte boolean Zugriff auf Projektverwaltung
protokolle boolean Zugriff auf Aktivitätsprotokolle

📋 Lizenzverwaltung

Basis-URL: https://creativeskyline.de/api/team https://creativeskyline.de/api/team/members https://creativeskyline.de/api/team/invitations https://creativeskyline.de/api/team/licenses
Automatische Lizenzvalidierung
Lizenzen werden automatisch geprüft, wenn Berechtigungen zugewiesen werden. Wenn keine Lizenzen verfügbar sind, gibt der Endpoint einen 403-Fehler zurück.

Lizenzen abrufen

GET /api/team/licenses

Ruft detaillierte Informationen über alle Lizenzen und deren Nutzung ab (Limit, belegt, verfügbar).

Beispiel-Response:

{"success": true, "data": {"ai": {"module": "FlowAI", "limit": 5, "used": 3, "available": 2}, "tt": {"module": "FlowTime", "limit": 10, "used": 7, "available": 3}, "td": {"module": "FlowTasks", "limit": 10, "used": 4, "available": 6}}}