Organisationen

Die Organizations API ermöglicht die Verwaltung von Organisationen und deren Mitgliedern.

Endpunkte

Methode	Endpunkt	Beschreibung
`GET`	`/api/v1/organizations/{orgId}`	Organisation abrufen
`PUT`	`/api/v1/organizations/{orgId}`	Organisation aktualisieren
`POST`	`/api/v1/organizations/{orgId}/logo`	Logo hochladen
`DELETE`	`/api/v1/organizations/{orgId}/logo`	Logo entfernen
`POST`	`/api/v1/organizations/{orgId}/banner`	Banner hochladen
`DELETE`	`/api/v1/organizations/{orgId}/banner`	Banner entfernen
`GET`	`/api/v1/organizations/{orgId}/notifications`	Benachrichtigungen
`PUT`	`/api/v1/organizations/{orgId}/notifications`	Benachrichtigungen aktualisieren
`POST`	`/api/v1/organizations/{orgId}/reinvite`	Mitglied erneut einladen
`GET`	`/api/v1/organizations/{orgId}/usage`	Nutzungsstatistiken

Das Organization-Objekt

{
  "id": "org_xyz789",
  "name": "Meine Firma GmbH",
  "slug": "meine-firma",
  "logo": "https://cdn.codefluss.com/orgs/org_xyz789/logo.png",
  "banner": "https://cdn.codefluss.com/orgs/org_xyz789/banner.jpg",
  "description": "Digitalagentur für moderne Weblösungen",
  "website": "https://meine-firma.de",
  "email": "kontakt@meine-firma.de",
  "address": {
    "street": "Hauptstraße 1",
    "city": "Frankfurt",
    "postalCode": "60311",
    "country": "DE"
  },
  "members": [
    {
      "id": "user_abc123",
      "name": "Max Mustermann",
      "email": "max@meine-firma.de",
      "role": "owner",
      "joinedAt": "2025-06-15T10:00:00Z"
    }
  ],
  "subscription": {
    "plan": "professional",
    "status": "active"
  },
  "createdAt": "2025-06-15T10:00:00Z",
  "updatedAt": "2026-01-22T14:30:00Z"
}

Organisation abrufen

GET /api/v1/organizations/{orgId}

Organisation aktualisieren

PUT /api/v1/organizations/{orgId}

{
  "name": "Neue Firma GmbH",
  "description": "Aktualisierte Beschreibung",
  "website": "https://neue-firma.de",
  "email": "info@neue-firma.de"
}

Logo hochladen

POST /api/v1/organizations/{orgId}/logo
Content-Type: multipart/form-data

curl -X POST "https://api.codefluss.com/v1/organizations/org_xyz789/logo" \
  -H "Authorization: Bearer cf_live_abc123..." \
  -F "file=@/path/to/logo.png"

Anforderungen:

Format: PNG, SVG (empfohlen)
Max. Größe: 2 MB
Empfohlene Größe: 400x400px (quadratisch)

Nutzungsstatistiken

GET /api/v1/organizations/{orgId}/usage

{
  "success": true,
  "data": {
    "projects": {
      "used": 8,
      "limit": 20,
      "percentage": 40
    },
    "storage": {
      "used": 2500000000,
      "usedFormatted": "2.5 GB",
      "limit": 53687091200,
      "limitFormatted": "50 GB",
      "percentage": 5
    },
    "aiCredits": {
      "used": 450,
      "limit": 1000,
      "percentage": 45,
      "resetsAt": "2026-02-01T00:00:00Z"
    },
    "websites": {
      "used": 3,
      "limit": 10
    },
    "members": {
      "used": 5,
      "limit": 10
    }
  }
}

Mitglied erneut einladen

POST /api/v1/organizations/{orgId}/reinvite

{
  "email": "neues-mitglied@example.com"
}

Mitgliederrollen

Rolle	Beschreibung
`owner`	Vollzugriff, kann Organisation löschen
`admin`	Kann Mitglieder und Einstellungen verwalten
`editor`	Kann Projekte und Inhalte bearbeiten
`viewer`	Nur Lesezugriff

Fehler

Code	Beschreibung
`400`	Ungültige Daten
`401`	Nicht authentifiziert
`403`	Keine Berechtigung für diese Organisation
`404`	Organisation nicht gefunden

Nächste Schritte

Kontoverwaltung – Eigenes Konto verwalten
Onboarding – Onboarding-Status