Espace de travail

Votre espace de travail est l'unité de travail dans Bird. Il contient vos domaines, vos clés API, vos envois et vos accès d'équipe. Le tableau de bord est centré sur l'espace de travail, et chaque action s'effectue au sein de votre espace de travail. Votre compte est rattaché à une seule région et contient vos informations de facturation.

Pour renommer l'espace de travail actuel, ouvrez Settings > General, modifiez Name, puis quittez le champ pour enregistrer. La modification nécessite l'autorisation de gérer cet espace de travail.

Pour créer un autre espace de travail, ouvrez la page Workspaces de votre organisation et choisissez Create workspace. Saisissez Workspace name et confirmez. Cette possibilité dépend des accès de votre organisation et de sa limite d'espaces de travail. Si la création est désactivée, consultez le motif affiché. Passer à un espace de travail existant ne crée pas de nouvel espace de travail.

Régions

Votre compte est lié à une seule région, actuellement us1 (États-Unis) ou eu1 (Union européenne). La région est choisie à l'inscription et ne peut pas être modifiée : vos données et votre infrastructure d'envoi y résident, et le trafic API est dirigé vers l'hôte de cette région, https://us1.platform.bird.com ou https://eu1.platform.bird.com. La région est intégrée dans le préfixe de chaque clé API (bk_us1_...), de sorte que les requêtes se routent d'elles-mêmes. Consultez URL de base et régions pour les règles de routage et ce qui se passe lorsqu'une requête atteint la mauvaise région.

Comment une requête trouve votre espace de travail

L'API de Bird utilise des routes plates (/v1/email/messages, /v1/sms/messages) sans segment d'espace de travail dans le chemin. C'est l'identifiant qui porte le contexte : une clé API est liée à votre espace de travail, ce qui fixe aussi son organisation et sa région, et une requête n'a besoin de rien d'autre que la clé elle-même. Une requête qui désigne un contexte en contradiction avec sa clé est rejetée comme malformée (400) au lieu d'être réinterprétée silencieusement.

La question de savoir si la requête est ensuite autorisée est distincte, résolue par les portées de clé pour les clés API et par les rôles pour les personnes travaillant dans le tableau de bord.

Fermeture d'une organisation

La fermeture d'une organisation est définitive et volontairement difficile à déclencher par accident. Un propriétaire en fait la demande, puis Bird envoie un lien de confirmation par e-mail. Tant que vous n'avez pas confirmé en suivant ce lien, rien ne change. Pour fermer votre propre compte utilisateur plutôt qu'une organisation, consultez Fermer votre compte.

Une fois la confirmation effectuée :

• Le verrouillage est immédiat. Votre compte disparaît du tableau de bord, ses clés API cessent de s'authentifier et sont révoquées, les envois s'arrêtent et tout abonnement actif est annulé.
• Un délai de grâce de 7 jours suit. Les données, la configuration et les appartenances d'équipe sont conservées intactes. L'e-mail de fermeture contient un lien d'annulation : en le suivant dans ce délai, vous restaurez l'accès. Tout est rétabli sauf les clés API, qui ont été révoquées au verrouillage et doivent être régénérées.
• La purge est ensuite irréversible. Après ce délai, un nettoyage s'exécute et supprime tout : domaines, suppressions, points de terminaison webhook, modèles, appartenances, données. Rien ne peut être récupéré une fois la purge commencée.

Étapes suivantes

• Authentification et clés API : comment les clés sont liées à un espace de travail
• Utilisateurs, équipes et rôles : rôles de l'espace de travail et contrôle d'accès, y compris les rôles au niveau du compte pour la facturation
• URL de base et régions : hôtes régionaux et routage