Organisationen

Eine Organisation ist die übergeordnete Abrechnungs- und Zugriffssteuerungseinheit in Crowdee. Alle Credits, Module und Teammitglieder werden auf Organisationsebene verwaltet. Projekte befinden sich innerhalb von Organisationen.

Organisation erstellen

Nach der Registrierung können Sie eine Organisation über das Dashboard anlegen. Um eine Organisation über die API zu erstellen:

curl -X POST https://api.crowdee.ai/v2/organizations \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Media Verification",
    "description": "Verification workflows for the Acme newsroom"
  }'

Guthaben & Credits

Crowdee verwendet ein Prepaid-Credit-Modell. Credits werden als balance_cents in der Organisation gespeichert und beim Abschluss von Pipeline-Läufen abgezogen. Ein Guthaben von 0 verhindert den Start neuer Verifizierungsläufe.

Beispiel eines Organisationsobjekts:

{
  "id": "org_abc123",
  "name": "Acme Media Verification",
  "balance_cents": 4250,
  "modules": ["content_verification"],
  "createdAt": "2024-10-01T09:00:00Z"
}

balance_cents ist eine Ganzzahl, die Euro-Cent repräsentiert — 4250 entspricht €42,50. Das aktuelle Guthaben kann jederzeit abgefragt werden:

curl https://api.crowdee.ai/v2/organizations/{orgId} \
  -H "X-API-Key: crw_YOUR_API_KEY"

Aufladen per PayPal im Dashboard unter Einstellungen → Abrechnung → Credits hinzufügen, oder wenden Sie sich für die Rechnungsstellung an sales@crowdee.ai bei Managed- und Enterprise-Tarifen.

Module

Module schalten Funktionsbereiche innerhalb einer Organisation frei. Sie werden vom Crowdee-Team bei der Kontoaktivierung aktiviert.

Mitgliederrollen

Organisationsadministratoren können Mitglieder einladen und Rollen zuweisen. Rollen bestimmen, was jedes Mitglied innerhalb der Organisation und ihrer Projekte tun kann — eine vollständige Übersicht finden Sie in der Tabelle der Rollenberechtigungen.

Mitglied über die API einladen:

curl -X POST https://api.crowdee.ai/v2/organizations/{orgId}/invite \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "colleague@example.com", "role": "user"}'

Gültige Rollen: viewer, user, admin. Nur Superadministratoren können die Rolle superadmin vergeben.

Mehrere Organisationen

Ein einzelnes Benutzerkonto kann mehreren Organisationen angehören. Verwenden Sie eine Standardorganisation der Einfachheit halber, oder wechseln Sie den Kontext pro Anfrage mit einem organisationsspezifischen API-Schlüssel.

Standardorganisation festlegen:

curl -X PUT https://api.crowdee.ai/v2/users/me/organizations/{orgId}/default \
  -H "X-API-Key: crw_YOUR_API_KEY"

API-Schlüssel können bei der Erstellung auf eine bestimmte Organisation beschränkt werden. Ein eingeschränkter Schlüssel operiert ausschließlich innerhalb dieser Organisation — Anfragen an Ressourcen anderer Organisationen werden abgelehnt, selbst wenn der Benutzer Mitglied beider Organisationen ist.