APIs de admin para organizaciones Enterprise

Las APIs de admin de Notion permiten que tu organización gestione trabajo de admin con código. Esto incluye tareas comunes, como Iniciar Exportar del espacio de trabajo, crear y liberar Retención legal, cerrar la sesión de usuarios administrados en Notion y más.

Puedes configurarlo en la configuración de tu organización. Creas un bot de admin para tu organización y luego le otorgas un token con solo el acceso que necesita.

• Tu organización debe estar en el plan Enterprise.

• Debes ser propietario de la organización.

• Esto está diseñado para equipos de admin, TI, seguridad y cumplimiento. Los miembros e invitados no notarán ningún cambio en su trabajo diario.

1. Abre el selector de espacio de trabajo y selecciona Gestionar organización.

2. Ve a General, luego abre Gestionar tokens de API de admin a nivel de organización.

3. Selecciona Crear conexión.

4. Dale a la conexión un nombre que tu equipo reconozca, como “Automatización de cumplimiento”, y selecciona solo el acceso que necesite. Si una conexión solo se usa para Exportar, no le des acceso a Retención legal.

5. Selecciona Crear token, luego copia el token y guárdalo en el administrador de secretos que tu equipo ya utiliza.

Verás la nueva conexión en la configuración de tu organización, junto con quién la creó y cuándo. Puedes volver y Copiar el token en cualquier momento desde el menú de la conexión.

• Elige el conjunto de acceso más pequeño que permita realizar el trabajo.

• Rota los tokens según la frecuencia que establezca tu equipo de seguridad.

• Elimina un token de inmediato si se comparte por error o si la persona que lo poseía cambia de rol. Cualquier script que utilice ese token dejará de funcionar inmediatamente.

• No puedes limitar un token de admin a direcciones IP o redes específicas. Usa los controles que ya tienes, como almacenar tokens en un administrador de secretos y ejecutar llamadas desde sistemas en los que confíes.

Las acciones realizadas con un token de admin aparecen en tu registro de auditoría. El bot de admin aparece como el actor, por lo que puedes distinguir el trabajo automatizado del trabajo humano.

• La llamada es rechazada. Verifica que tu organización tenga el plan Enterprise.

• Obtienes un error de permiso. Verifica que el token tenga acceso a la acción que llamas. Un token con alcance para Exportar no puede crear una Retención legal.

• Una llamada de cierre de sesión no hace nada. Verifica que la cuenta sea un usuario administrado. Las cuentas fuera de tus dominios verificados no están cubiertas.

Para conocer los formatos de solicitud, los parámetros y los ejemplos de código, consulta la referencia de la API de admin en la documentación para desarrolladores.