Organisation
Einstellungen deiner Organisation anzeigen und aktualisieren.
Die Organisation ist die oberste Mandanten-Ebene in Spedy. Alle Boards, Nutzer und Daten gehören zu einer Organisation. Die meisten Organisationseinstellungen erfordern die settings:edit-Berechtigung.
Aktuelle Organisation abrufen
GET /api/v1/organizations/currentGibt die Organisation des aktuell authentifizierten Nutzers zurück.
Beispiel-Response
{
"id": "org_abc123",
"name": "Acme Corp",
"slug": "acme-corp",
"logo": "https://cdn.spedy.ai/logos/acme.png",
"createdAt": "2025-01-01T00:00:00Z"
}Organisation aktualisieren
PATCH /api/v1/organizations/currentBerechtigung erforderlich: settings:edit
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | string | Nein | Organisationsname |
| slug | string | Nein | URL-freundlicher Slug (Kleinbuchstaben, alphanumerisch, Bindestriche) |
| logo | string | Nein | Logo-URL |
Beispiel-Request
{
"name": "Acme Corporation",
"slug": "acme-corporation"
}Organisation löschen
DELETE /api/v1/organizations/currentBerechtigung erforderlich: settings:edit
Löscht die Organisation und alle zugehörigen Daten dauerhaft. Diese Aktion kann nicht rückgängig gemacht werden.
Request Body
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| confirmation | string | Ja | Muss dem Organisationsnamen entsprechen, um die Löschung zu bestätigen |