Zum Inhalt springen

Mitglieder

Organisationsmitglieder sind Nutzer, die Zugriff auf deine Capgo-Organisation haben. Jedes Mitglied hat eine bestimmte Rolle, die seine Berechtigungen innerhalb der Organisation festlegt. Eine effektive Mitgliederverwaltung ist entscheidend für Sicherheit und Zusammenarbeit in deinem Team.

  • read-: Kann Ressourcen einsehen, aber keine Änderungen vornehmen
  • Upload: Kann neue Bundles hochladen und Ressourcen einsehen
  • schreiben: Kann Ressourcen ändern und Bundles hochladen
  • admin: Kann Organisationseinstellungen und Mitglieder verwalten
  • Super-Admin: Hat die volle Kontrolle über die Organisation
  • invite_read: Ausstehende Einladung für Lesezugriff
  • invite_upload: Ausstehende Einladung für Upload-Zugriff
  • Einladungen schreiben: Ausstehende Einladung für Schreibzugriff
  • Admin einladen: Ausstehende Einladung für Admin-Zugriff
  • Super-Admin einladen: Ausstehende Einladung für Super-Admin-Zugriff
  1. Rollenzuweisung: Wende bei der Rollenzuweisung das Least-Privilege-Prinzip an
  2. Regelmäßige Audits: Prüfe regelmäßig den Mitgliederzugriff und entferne ungenutzte Accounts
  3. Onboarding: Sorgen Sie für einen klaren Prozess, um neue Mitglieder hinzuzufügen und Rollen zuzuweisen
  4. Offboarding: Entziehen Sie Mitgliedern, die die Organisation verlassen, umgehend den Zugriff

https://api.capgo.app/organization/members/

Fügen Sie einer Organisation ein neues Mitglied hinzu oder aktualisieren Sie die Rolle eines bestehenden Mitglieds. Beachten Sie, dass Sie nur Nutzer einladen können, die bereits ein Capgo-Konto haben – die E-Mail-Adresse muss zu einem bestehenden Capgo-Nutzer gehören.

interface MemberCreate {
orgId: string
email: string
role: "read" | "upload" | "write" | "admin" | "super_admin"
}
Terminalfenster
curl -X POST \
-H "authorization: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"orgId": "org_123",
"email": "newmember@example.com",
"role": "write"
}' \
https://api.capgo.app/organization/members/
{
"status": "OK",
"data": {
"uid": "user_789",
"email": "newmember@example.com",
"role": "invite_write",
"image_url": null
}
}

Hinweise:

  • Wenn ein neues Mitglied hinzugefügt wird, erhält es eine Einladung per E-Mail. Die Rolle wird mit „invite_“ vorangestellt, bis die Einladung akzeptiert wird.
  • Der Benutzer muss bereits ein Capgo-Konto haben, bevor er eingeladen werden kann. Falls nicht, sollte er zuerst eines unter folgender Adresse erstellen: https://capgo.app/register/

https://api.capgo.app/organization/members/

Alle Mitglieder einer Organisation abrufen.

interface MemberQuery {
orgId: string
}
interface Member {
uid: string;
email: string;
image_url: string;
role: "invite_read" | "invite_upload" | "invite_write" | "invite_admin" | "invite_super_admin" | "read" | "upload" | "write" | "admin" | "super_admin";
}
Terminalfenster
curl -H "authorization: your-api-key" \
"https://api.capgo.app/organization/members/?orgId=org_123"
{
"data": [
{
"uid": "user_123",
"email": "john@example.com",
"image_url": "https://example.com/avatar.png",
"role": "admin"
},
{
"uid": "user_456",
"email": "jane@example.com",
"image_url": "https://example.com/avatar2.png",
"role": "write"
},
{
"uid": "user_789",
"email": "bob@example.com",
"image_url": null,
"role": "invite_read"
}
]
}

https://api.capgo.app/organization/members/

Entfernt ein Mitglied aus einer Organisation. Dadurch wird der Zugriff sofort entzogen.

interface MemberDelete {
orgId: string
email: string
}
Terminalfenster
curl -X DELETE \
-H "authorization: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"orgId": "org_123",
"email": "user@example.com"
}' \
https://api.capgo.app/organization/members/
{
"status": "OK"
}

Alle Fehler verwenden das Standardfehlerformat, das in der API Übersicht.

Häufige Fehlerszenarien und deren Antworten:

// The API key has no access to the organization
{
"error": "cannot_access_organization",
"message": "You can't access this organization",
"moreInfo": { "orgId": "046a36ac-e03c-4590-9257-bd6c9dba9ee8" }
}
// Unknown role on update
{
"error": "invalid_role",
"message": "Invalid role",
"moreInfo": { "role": "owner" }
}
// Changing the role of the user who owns the API key
{
"error": "cannot_change_own_role",
"message": "You cannot change your own role",
"moreInfo": {}
}
// Removing a user who is not a member (HTTP 404)
{
"error": "organization_member_not_found",
"message": "User is not a member of this organization",
"moreInfo": { "orgId": "046a36ac-e03c-4590-9257-bd6c9dba9ee8", "email": "user@example.com" }
}
// Removing the last super admin
{
"error": "CANNOT_REMOVE_LAST_SUPER_ADMIN",
"message": "Cannot remove the last super admin from the organization",
"moreInfo": { "orgId": "046a36ac-e03c-4590-9257-bd6c9dba9ee8" }
}
  1. Team-Erweiterung: Neue Teammitglieder mit passenden Rollen hinzufügen
  2. Zugriffskontrolle: Berechtigungen von Mitgliedern verwalten, wenn sich Zuständigkeiten ändern
  3. Security-Audit: Mitgliederliste und Rollen regelmäßig überprüfen
  4. Team-Neustrukturierung: Rollen bei organisatorischen Änderungen aktualisieren

Wenn du es nutzt Mitglieder um Sicherheit und Compliance zu planen, verbinden Sie es mit Verschlüsselung für die Implementierungsdetails in Encryption, Konformität für das Implementierungsdetail in Compliance, Capgo Security-Scanner für den Produkt-Workflow im Capgo Security Scanner, Capgo Sicherheit für den Produkt-Workflow in Capgo Security und Capgo Trust Center für den Produkt-Workflow im Capgo Trust Center.