Workspace

Ihr Workspace ist die Arbeitseinheit in Bird. Er enthält Ihre Domains, API-Keys, Sendungen und den Teamzugriff. Das Dashboard ist Workspace-zentriert, und jede Aktion findet innerhalb Ihres Workspace statt. Ihr Konto ist an eine einzelne Region gebunden und enthält Ihre Abrechnungsinformationen.

Um den aktuellen Workspace umzubenennen, öffnen Sie Settings > General, bearbeiten Sie Name und verlassen Sie dann das Feld, um zu speichern. Zum Bearbeiten benötigen Sie die Berechtigung, diesen Workspace zu verwalten.

Um einen weiteren Workspace zu erstellen, öffnen Sie die Seite Workspaces Ihrer Organisation und wählen Sie Create workspace. Geben Sie Workspace name ein und bestätigen Sie. Ob Sie einen Workspace erstellen können, hängt vom Zugriff und vom Workspace-Limit Ihrer Organisation ab. Wenn die Erstellung deaktiviert ist, prüfen Sie den angezeigten Grund. Wenn Sie zu einem bestehenden Workspace wechseln, wird kein neuer erstellt.

Regionen

Ihr Konto ist an genau eine Region gebunden, derzeit us1 (USA) oder eu1 (Europäische Union). Die Region wird bei der Registrierung gewählt und kann nicht geändert werden: Ihre Daten und Ihre Sendeinfrastruktur befinden sich dort, und API-Traffic geht an den Host dieser Region, https://us1.platform.bird.com oder https://eu1.platform.bird.com. Die Region ist in jedes API-Key-Präfix eingebettet (bk_us1_...), sodass Anfragen automatisch richtig geroutet werden. Die Routing-Regeln und was mit einer Anfrage in der falschen Region passiert, finden Sie unter Base URLs & Regionen.

Wie eine Anfrage Ihren Workspace findet

Die API von Bird verwendet flache Routen (/v1/email/messages, /v1/sms/messages) ohne Workspace-Segment im Pfad. Stattdessen trägt das Credential den Kontext: Ein API-Key ist an Ihren Workspace gebunden, wodurch auch Organisation und Region feststehen. Eine Anfrage braucht also nichts außer dem Key selbst. Eine Anfrage, die einen Kontext angibt, der ihrem Key widerspricht, wird als fehlerhaft abgelehnt (400), statt stillschweigend uminterpretiert zu werden.

Ob die Anfrage dann erlaubt ist, ist eine separate Frage, die durch Key-Scopes für API-Keys und durch Rollen für Personen beantwortet wird, die im Dashboard arbeiten.

Organisation schließen

Die Schließung einer Organisation ist dauerhaft und absichtlich so gestaltet, dass sie nicht versehentlich passiert. Ein Inhaber beantragt sie, und Bird sendet einen Bestätigungslink per E-Mail. Solange Sie nicht über diesen Link bestätigen, ändert sich nichts. Wenn Sie Ihr eigenes Benutzerkonto statt einer Organisation schließen möchten, lesen Sie Konto schließen.

Nach der Bestätigung:

• Die Sperrung erfolgt sofort. Ihr Konto verschwindet aus dem Dashboard, seine API-Keys authentifizieren nicht mehr und werden widerrufen, der Versand stoppt, und jedes aktive Abonnement wird gekündigt.
• Danach folgt eine Kulanzfrist von 7 Tagen. Daten, Konfiguration und Team-Mitgliedschaften bleiben unverändert erhalten. Die Schließungs-E-Mail enthält einen Abbruch-Link. Wenn Sie ihm innerhalb der Frist folgen, wird der Zugang wiederhergestellt. Alles wird wiederhergestellt außer den API-Keys, die bei der Sperrung widerrufen wurden und neu ausgestellt werden müssen.
• Danach ist die Löschung unwiderruflich. Nach Ablauf der Frist läuft die Bereinigung und entfernt alles: Domains, Unterdrückungen, Webhook-Endpunkte, Templates, Mitgliedschaften, Daten. Sobald die Löschung beginnt, lässt sich nichts mehr wiederherstellen.

Nächste Schritte

• Authentifizierung & API-Keys: wie Keys an einen Workspace gebunden sind
• Benutzer, Teams & Rollen: Workspace-Rollen und Zugriffskontrolle, einschließlich Rollen auf Kontoebene für die Abrechnung
• Base URLs & Regionen: regionale Hosts und Routing