Espacio de trabajo
Tu espacio de trabajo es la unidad de trabajo en Bird. Contiene tus dominios, claves API, envíos y acceso de equipo. El panel está organizado por espacio de trabajo, y cada acción ocurre dentro de tu espacio de trabajo. Tu cuenta está vinculada a una sola región y contiene tu información de facturación.
Para cambiar el nombre del espacio de trabajo actual, abre Settings > General, edita Name y sal del campo para guardar. Para editarlo necesitas permiso para gestionar ese espacio de trabajo.
Para crear otro espacio de trabajo, abre la página Workspaces de tu organización y elige Create workspace. Introduce Workspace name y confirma. La disponibilidad depende del acceso de tu organización y de su límite de espacios de trabajo; si la creación está desactivada, consulta el motivo que se muestra. Cambiar a un espacio de trabajo existente no crea uno nuevo.
Regiones
Tu cuenta está fijada a exactamente una región, actualmente us1 (Estados Unidos) o eu1 (Unión Europea). La región se elige al registrarte y no se puede cambiar: tus datos e infraestructura de envío residen ahí, y el tráfico API se dirige al host de esa región, https://us1.platform.bird.com o https://eu1.platform.bird.com. La región está incorporada en cada prefijo de clave API (bk_us1_...), de modo que las solicitudes se enrutan solas. Consulta URLs base y regiones para las reglas de enrutamiento y lo que ocurre con una solicitud que llega a la región incorrecta.
Cómo una solicitud encuentra tu espacio de trabajo
La API de Bird usa rutas planas (/v1/email/messages, /v1/sms/messages) sin segmento de espacio de trabajo en la ruta. La credencial lleva el contexto: una clave API está vinculada a tu espacio de trabajo, lo que fija también su organización y región, así que una solicitud no necesita nada más que la propia clave. Una solicitud que indica un contexto en contradicción con su clave se rechaza como mal formada (400) en lugar de reinterpretarse silenciosamente.
Si la solicitud está permitida es una cuestión aparte, resuelta por los alcances de clave para claves API y por los roles para las personas que trabajan en el panel.
Cerrar una organización
Cerrar una organización es permanente y deliberadamente difícil de hacer por accidente. Un propietario lo solicita y Bird envía por correo un enlace de confirmación. Hasta que confirmes siguiendo ese enlace, nada cambia. Para cerrar tu propia cuenta de usuario en lugar de una organización, consulta Cerrar tu cuenta.
Una vez confirmado:
- El bloqueo es inmediato. Tu cuenta desaparece del panel, sus claves API dejan de autenticar y se revocan, el envío se detiene y cualquier suscripción activa se cancela.
- Sigue un periodo de gracia de 7 días. Los datos, la configuración y las membresías de equipo se conservan intactos. El correo de cierre incluye un enlace de cancelación; si lo sigues dentro de ese periodo, se restaura el acceso. Todo vuelve excepto las claves API, que se revocaron en el bloqueo y deben volver a emitirse.
- Después, la purga es irreversible. Pasado el periodo, se ejecuta la limpieza, que elimina todo: dominios, supresiones, endpoints de webhook, plantillas, membresías y datos. Una vez que comienza la purga, no se puede recuperar nada.
Próximos pasos
- Autenticación y claves API: cómo las claves se vinculan a un espacio de trabajo
- Usuarios, equipos y roles: roles del espacio de trabajo y control de acceso, incluidos los roles a nivel de cuenta para facturación
- URLs base y regiones: hosts regionales y enrutamiento
Recursos relacionados
Continúa con la documentación, guías y ejemplos de este tema.