APIs de administrador para organizações Enterprise

As APIs de administrador do Notion permitem que sua organização lide com o trabalho de administrador usando código. Isso inclui tarefas comuns como Iniciar uma Exportação de espaço de trabalho, criar e liberar retenções legais, desconectar usuários gerenciados do Notion e muito mais.

Configure isso nas configurações da sua organização. Crie um bot de administrador para sua organização e forneça a ele um token apenas com o acesso necessário.

• Sua organização precisa estar no Plano Enterprise.

• Você deve ser proprietário da organização.

• Isso foi criado para equipes de administrador, TI, segurança e conformidade. Membros e convidados não notarão nenhuma mudança em seu trabalho diário.

1. Abra o seletor de espaço de trabalho e selecione Gerenciar a organização.

2. Vá para Geral e abra Gerenciar tokens de API de administrador em nível de organização.

3. Selecione Criar conexão.

4. Dê à conexão um nome que sua equipe reconheça, como “Automação de conformidade”, e escolha apenas o acesso necessário. Se uma conexão executa apenas exportações, não conceda a ela acesso a retenção legal.

5. Selecione Criar token, depois copie o token e salve-o no gerenciador de segredos que sua equipe já utiliza.

Você verá a nova conexão listada nas configurações da sua organização, junto com quem a criou e quando. Você pode voltar e copiar o token novamente a qualquer momento no menu da conexão.

• Escolha o menor conjunto de acesso que ainda dê conta do recado.

• Rotacione os tokens de acordo com o cronograma definido pela sua equipe de segurança.

• Exclua um token imediatamente se ele for compartilhado por engano ou se a pessoa que o possuía mudar de função. Qualquer script que use esse token para de funcionar imediatamente.

• Você não pode limitar um token de administrador a endereços IP ou redes específicos. Use os controles que você já possui, como armazenar tokens em um gerenciador de segredos e executar chamadas a partir de sistemas em que você confia.

As ações realizadas com um token de administrador aparecem no seu registro de auditoria. O bot de administrador é listado como o autor, para que você possa distinguir o trabalho automatizado do trabalho humano.

• A chamada é rejeitada. Verifique se sua organização está no Plano Enterprise.

• Você recebe um erro de permissão. Verifique se o token tem acesso à ação que você está chamando. Um token com escopo para exportações não pode criar uma retenção legal.

• Uma chamada de logout não faz nada. Verifique se a conta é um usuário gerenciado. Contas fora dos seus domínios verificados não são cobertas.

Para formatos de solicitação, parâmetros e exemplos de código, consulte a referência da API de administrador na documentação do desenvolvedor.