Organizations API

Verwalten Sie Organisationseinstellungen, listen Sie Mitglieder auf und laden Sie sie ein, prüfen Sie das Guthaben und konfigurieren Sie Module.

Organisationen sind die übergeordnete Abrechnungs- und Zugriffssteuerungsebene in Crowdee. Jedes Projekt, jeder API-Schlüssel und jeder Verifikationslauf gehört zu einer Organisation. Die meisten Benutzer gehören einer einzigen Organisation an; Enterprise-Konten können mehrere Organisationen haben.

Endpunkt-Referenz

Methode	Pfad	Beschreibung
`GET`	`/v2/organizations`	Ihre Organisationen auflisten
`POST`	`/v2/organizations`	Eine Organisation erstellen
`GET`	`/v2/organizations/{orgId}`	Organisationsdetails abrufen
`PUT`	`/v2/organizations/{orgId}`	Organisation aktualisieren
`GET`	`/v2/organizations/{orgId}/users`	Mitglieder auflisten
`POST`	`/v2/organizations/{orgId}/invite`	Ein Mitglied einladen
`GET`	`/v2/organizations/{orgId}/invitations`	Ausstehende Einladungen auflisten
`GET`	`/v2/organizations/{orgId}/billing`	Abrechnungsinformationen abrufen

Ihre Organisationen auflisten

GET /v2/organizations

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

Eine Organisation abrufen

GET /v2/organizations/{orgId}

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

Antwort

{
  "id": "org_xyz789",
  "name": "Acme News Desk",
  "slug": "acme-news-desk",
  "balance_cents": 48500,
  "currency": "EUR",
  "modules": ["content_verification", "crowdsourcing"],
  "plan": "professional",
  "memberCount": 8,
  "createdAt": "2024-01-10T09:00:00Z",
  "updatedAt": "2024-11-14T16:30:00Z"
}

balance_cents ist das aktuelle Vorauszahlungsguthaben in EUR-Cent (z. B. 48500 = €485,00). Siehe Guthaben weiter unten.

Mitglieder

GET /v2/organizations/{orgId}/users

Gibt alle aktiven Mitglieder der Organisation mit ihren zugewiesenen Rollen zurück.

curl https://api.crowdee.ai/v2/organizations/org_xyz789/users \
  -H "X-API-Key: crw_YOUR_API_KEY"

Antwort

{
  "data": [
    {
      "userId": "usr_abc111",
      "email": "alice@acmenews.com",
      "name": "Alice Berger",
      "role": "admin",
      "joinedAt": "2024-01-10T09:05:00Z"
    },
    {
      "userId": "usr_abc222",
      "email": "bob@acmenews.com",
      "name": "Bob Hartmann",
      "role": "user",
      "joinedAt": "2024-03-22T11:00:00Z"
    }
  ],
  "total": 8
}

Rollen-Referenz

Rolle	Berechtigungen
`viewer`	Nur-Lese-Zugriff auf Projekte, Dateien und Laufergebnisse
`user`	Vollständiger Lese-/Schreibzugriff auf Projekte und Läufe; kann keine Mitglieder oder Abrechnung verwalten
`admin`	Vollständiger Zugriff einschließlich Mitgliederverwaltung, Einladungen und API-Schlüsselverwaltung
`superadmin`	Crowdee-intern; nicht über die API zuweisbar

Ein Mitglied einladen

POST /v2/organizations/{orgId}/invite

Sendet eine E-Mail-Einladung an die angegebene Adresse. Der Empfänger muss die Einladung über den Link in der E-Mail annehmen, bevor er in der Mitgliederliste erscheint.

Anfrage-Body

Feld	Typ	Erforderlich	Beschreibung
`email`	string	Ja	Einzuladende E-Mail-Adresse
`role`	string	Ja	`"viewer"`, `"user"` oder `"admin"`

Einladungen laufen nach 2 Wochen ab. Falls der Eingeladene noch nicht akzeptiert hat, senden Sie die Einladung erneut über diesen Endpunkt mit derselben E-Mail-Adresse — bestehende ausstehende Einladungen für diese Adresse werden ersetzt.

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

Antwort

{
  "id": "inv_def999",
  "organizationId": "org_xyz789",
  "email": "carol@acmenews.com",
  "role": "user",
  "status": "pending",
  "expiresAt": "2024-11-29T10:15:00Z",
  "createdAt": "2024-11-15T10:15:00Z"
}

Ausstehende Einladungen verwalten

GET /v2/organizations/{orgId}/invitations

Listet alle Einladungen auf, die gesendet wurden, aber noch nicht akzeptiert oder widerrufen wurden.

curl https://api.crowdee.ai/v2/organizations/org_xyz789/invitations \
  -H "X-API-Key: crw_YOUR_API_KEY"

Antwort

{
  "data": [
    {
      "id": "inv_def999",
      "email": "carol@acmenews.com",
      "role": "user",
      "status": "pending",
      "expiresAt": "2024-11-29T10:15:00Z",
      "createdAt": "2024-11-15T10:15:00Z"
    }
  ],
  "total": 1
}

Um eine Einladung zu widerrufen, bevor sie angenommen wird:

curl -X DELETE https://api.crowdee.ai/v2/invitations/inv_def999 \
  -H "X-API-Key: crw_YOUR_API_KEY"

Guthaben

Das Feld balance_cents im Organisationsobjekt enthält Ihr aktuelles Vorauszahlungsguthaben in EUR-Cent.

balance_cents: 48500  →  €485.00

Für das Aufladen des Guthabens verwenden Sie das Dashboard unter Einstellungen → Abrechnung, oder wenden Sie sich an sales@crowdee.ai für Rechnungszahlungen bei Professional- und Enterprise-Tarifen.

Um nur die Abrechnungsdetails ohne das vollständige Organisationsobjekt abzurufen:

curl https://api.crowdee.ai/v2/organizations/org_xyz789/billing \
  -H "X-API-Key: crw_YOUR_API_KEY"

{
  "organizationId": "org_xyz789",
  "plan": "professional",
  "balance_cents": 48500,
  "currency": "EUR",
  "lastTopUp": {
    "amount_cents": 100000,
    "date": "2024-10-01T00:00:00Z"
  }
}

Falls ein Verifikationslauf aufgrund unzureichenden Guthabens nicht fortgesetzt werden kann, gibt die API 402 PAYMENT_REQUIRED zurück.

Module

Das Array modules im Organisationsobjekt listet die für Ihr Konto aktivierten Funktionsmodule auf.

Modul	Beschreibung
`content_verification`	Zugriff auf alle 14 Verifikations-Pipelines und die Verifikationsläufe-API
`crowdsourcing`	Zugriff auf Tier-2/3-Pipelines, die menschliche Crowd-Review-Stufen beinhalten

{
  "modules": ["content_verification", "crowdsourcing"]
}

Der Versuch, einen Lauf zu starten, der ein Modul erfordert, das für Ihre Organisation nicht aktiviert ist, gibt 403 FORBIDDEN mit dem Code MODULE_NOT_ENABLED zurück.

Moduländerungen werden vom Crowdee-Team vorgenommen. Wenden Sie sich an hello@crowdee.ai, um zusätzliche Module für Ihre Organisation zu aktivieren oder zu testen.

On this page