エンタープライズ組織向け管理者API

このヘルプドキュメント内

設定を構成する代わりに、コードを使用して管理作業を実行します。

備考: この機能はエンタープライズプランでのみ利用可能であり、組織のオーナーのみが設定できます。

Notionの管理者APIを使用すると、組織の管理作業をコードで処理できます。これには、ワークスペースのエクスポートの開始、訴訟ホールドの作成と解除、管理対象ユーザーのNotionからのログアウトなど、一般的なタスクが含まれます。

これは組織の設定でセットアップできます。組織用の管理者ボットを作成し、必要なアクセス権のみを持つトークンを付与します。

ワークスペース切り替えメニューを開き、組織を管理するを選択します。
全般に移動し、組織レベルの管理者APIトークンを管理を開きます。
接続を作成を選択します。
チームが認識できる名前（「コンプライアンス自動化」など）を接続に付け、必要なアクセス権のみを選択します。接続がエクスポートのみを実行する場合は、訴訟ホールドのアクセスを付与しないでください。
トークンを作成を選択し、トークンをコピーして、チームが既に使用しているシークレットマネージャーに保存します。

新しい接続が組織の設定に一覧表示され、作成者と作成日時も表示されます。接続のメニューからいつでも戻ってトークンを再コピーできます。

ヒント: 各オートメーションに独自の接続とトークンを割り当ててください。1つのトークンを無効にする必要が生じても、他のオートメーションは引き続き実行されます。

業務を遂行できる最小限のアクセス権を選択してください。
セキュリティチームが設定したスケジュールに従ってトークンをローテーションしてください。
誤って共有された場合や、トークンの所有者が役割を変更した場合は、すぐにトークンを削除してください。そのトークンを使用しているスクリプトは直ちに動作を停止します。
管理者トークンを特定のIPアドレスやネットワークに制限することはできません。トークンをシークレットマネージャーに保存したり、信頼できるシステムから呼び出しを実行したりするなど、既存の管理方法を使用してください。

管理者トークンを使用して実行されたアクションは、監査ログに表示されます。管理者ボットが実行者として記録されるため、自動化された作業と人間による作業を区別できます。

呼び出しが拒否されます。組織がエンタープライズプランに加入していることを確認してください。
権限エラーが発生します。トークンが呼び出そうとしているアクションへのアクセス権を持っていることを確認してください。エクスポートにスコープ設定されたトークンでは、訴訟ホールドを作成できません。
ログアウトの呼び出しが機能しません。アカウントが管理対象ユーザーであることを確認してください。検証済みドメイン外のアカウントは対象外です。

リクエスト形式、パラメータ、コードサンプルについては、開発者向けドキュメントの管理者APIリファレンスを参照してください。

これはNotion API接続トークンと同じですか？

いいえ。接続トークンは1つのワークスペース内で機能し、ページコンテンツの読み取りや書き込みを行います。管理者トークンは組織に属しており、エクスポート、訴訟ホールド、ユーザーのログアウトといった管理者アクションのみを処理します。

これは組織の設定に代わるものですか？

いいえ。管理者APIで実行できるすべての操作は、引き続き組織の設定から手動で行うことができます。APIは、同じ作業を大規模に繰り返したい場合にご利用ください。

トークンを特定のIPアドレスに制限できますか？

現時点ではできません。IPアドレス制限はサインインするユーザーに適用されるものであり、管理者トークンには適用されません。