Dokumentation
Sign inGet started
Jetzt starten
Anleitungen
API-Referenz
SDKs
CLI
Wissensdatenbank
Changelog

Workspace

Your workspace is the unit of work in Bird. It holds your domains, API keys, sends, and team access. The dashboard is workspace-first, and every action takes place within your workspace. Your account is tied to a single region and holds your billing information.

Regions

Your account is pinned to exactly one region, currently us1 (United States) or eu1 (European Union). The region is chosen at signup and cannot be changed: your data and sending infrastructure live there, and API traffic goes to that region's host, https://us1.platform.bird.com or https://eu1.platform.bird.com. The region is baked into every API key prefix (bk_us1_...), so requests route themselves. See Base URLs & regions for the routing rules and what happens to a request that reaches the wrong region.

How a request finds your workspace

Bird's API uses flat routes (/v1/email/messages, /v1/members) with no workspace segment in the path. The credential carries the context instead: an API key is bound to your workspace, which fixes its organization and region too, so a request needs nothing beyond the key itself. A request that names a context contradicting its key is rejected as malformed (400) rather than silently reinterpreted.
Whether the request is then allowed is a separate question, answered by key scopes for API keys and by roles for people working in the dashboard.

Closing an account

Closing your account is permanent and deliberately hard to do by accident. Account closure is owner-initiated from account settings and triggers a confirmation email. Until you confirm by following the link Bird sends you, nothing changes.
Once confirmed:
  • Lockout is immediate. Your account disappears from the dashboard, its API keys stop authenticating and are revoked, sending stops, and any active subscription is canceled.
  • A 7-day grace window follows. Data, configuration, and team memberships are retained untouched. The closure email carries a cancel link, and following it inside the window restores access. Everything comes back except API keys, which were revoked at lockout and have to be re-issued.
  • Then the purge is irreversible. After the window, cleanup runs and reclaims everything: domains, suppressions, webhook endpoints, templates, memberships, data. Nothing can be recovered once the purge begins.

Next steps