Werkruimte

Je werkruimte is de werkeenheid in Bird. Deze bevat je domeinen, API-sleutels, verzendingen en teamtoegang. Het dashboard is werkruimte-georiënteerd en elke actie vindt plaats binnen je werkruimte. Je account is gekoppeld aan één regio en bevat je factureringsgegevens.

Om de huidige werkruimte een andere naam te geven, open je Settings > General, pas je Name aan en verlaat je het veld om op te slaan. Hiervoor heb je toestemming nodig om die werkruimte te beheren.

Om nog een werkruimte aan te maken, open je de pagina Workspaces van je organisatie en kies je Create workspace. Vul Workspace name in en bevestig. Of dit beschikbaar is, hangt af van de toegang en de werkruimtelimiet van je organisatie. Is aanmaken uitgeschakeld, bekijk dan de reden die wordt getoond. Overschakelen naar een bestaande werkruimte maakt geen nieuwe werkruimte aan.

Regio's

Je account is gekoppeld aan precies één regio: us1 (Verenigde Staten) of eu1 (Europese Unie). Je kiest de regio bij registratie en kunt die daarna niet wijzigen: je data en verzendinfrastructuur bevinden zich daar, en API-verkeer gaat naar de host van die regio, https://us1.platform.bird.com of https://eu1.platform.bird.com. De regio zit in elk API-sleutelprefix (bk_us1_...), waardoor verzoeken automatisch naar de juiste regio gaan. Zie Basis-URL's & regio's voor de routeringsregels en wat er gebeurt met een verzoek dat bij de verkeerde regio terechtkomt.

Hoe een verzoek je werkruimte vindt

De API van Bird gebruikt platte routes (/v1/email/messages, /v1/sms/messages) zonder werkruimtesegment in het pad. De credential draagt in plaats daarvan de context: een API-sleutel is gebonden aan je werkruimte, waarmee ook de organisatie en regio vastliggen, dus een verzoek heeft niets meer nodig dan de sleutel zelf. Een verzoek dat een context noemt die in tegenspraak is met de sleutel wordt afgewezen als onjuist gevormd (400) in plaats van stilzwijgend geherinterpreteerd.

Of het verzoek vervolgens wordt toegestaan is een aparte vraag, beantwoord door sleutelbereiken voor API-sleutels en door rollen voor mensen die in het dashboard werken.

Een organisatie sluiten

Het sluiten van een organisatie is permanent en bewust zo opgezet dat je het niet per ongeluk doet. Een eigenaar vraagt de sluiting aan, waarna Bird een bevestigingslink mailt. Zolang je niet bevestigt via die link, verandert er niets. Wil je je eigen gebruikersaccount sluiten in plaats van een organisatie, zie dan Je account sluiten.

Na bevestiging:

• De toegang wordt onmiddellijk geblokkeerd. Je account verdwijnt uit het dashboard, de API-sleutels werken niet meer voor authenticatie en worden ingetrokken, verzenden stopt en een actief abonnement wordt opgezegd.
• Daarna volgt een respijtperiode van 7 dagen. Data, configuratie en teamlidmaatschappen blijven onaangetast bewaard. De sluitingsmail bevat een annuleringslink. Volg je die binnen de periode, dan wordt de toegang hersteld. Alles komt terug behalve de API-sleutels, die bij de blokkering zijn ingetrokken en opnieuw moeten worden uitgegeven.
• Daarna is de verwijdering onomkeerbaar. Na de respijtperiode wordt een opschoonproces uitgevoerd dat alles verwijdert: domeinen, suppressies, webhook-endpoints, templates, lidmaatschappen en data. Zodra de verwijdering begint, kan niets meer worden hersteld.

Volgende stappen

• Authenticatie & API-sleutels: hoe sleutels aan een werkruimte zijn gebonden
• Gebruikers, teams & rollen: werkruimterollen en toegangsbeheer, inclusief rollen op accountniveau voor facturering
• Basis-URL's & regio's: regionale hosts en routering