> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Admin API

> Replit Enterprise Admin APIを使用して、アカウントの使用状況、ワークスペース、メンバー、プロジェクトにプログラムでアクセスします。

<Note>
  Admin APIは**ベータ版**です。利用可能なエンドポイントと動作は変更される場合があります。
</Note>

Admin APIは、Enterpriseアカウント管理者にアカウント分析および管理データへの読み取り専用のプログラムによるアクセスを提供します。これを使用して、Enterpriseアカウント向けの内部レポート、運用ワークフロー、統合を構築できます。

## Admin APIにアクセスできるユーザー

Admin APIは、Enterpriseアカウントの**アカウント管理者**のみが利用できます。アカウント管理者はAPIキーを作成・管理できます。ワークスペース管理者やその他のアカウントメンバーは、Admin APIにアクセスしたり、そのキーを作成したりすることはできません。

Enterprise管理者ロールの詳細については、[アカウントおよびワークスペース管理者](/ja/teams/identity-and-access-management/account-and-workspace-admins)を参照してください。

## APIキーを作成する

<Steps>
  <Step title="開発者設定を開く">
    Enterpriseアカウントで**設定**を開き、**開発者**を選択します。
  </Step>

  <Step title="APIキーを作成する">
    **APIキーを作成**を選択します。Admin APIキーは読み取り専用です。
  </Step>

  <Step title="キーを安全に保管する">
    `rpl_`で始まるキーをコピーし、安全なシークレットマネージャーに保管します。パスワードと同様に扱い、決して共有しないでください。
  </Step>

  <Step title="統合を認証する">
    APIリクエストとともにキーをBearerトークンとして送信します。
  </Step>
</Steps>

## できること

Admin APIは、以下の読み取り専用エンドポイントを提供します。

* **使用状況：** ワークスペース、メンバー、プロジェクト、期間でフィルタリングまたはグループ化された、アカウントの使用状況と総元帳コスト。
* **ワークスペース：** メンバー数やプロジェクト数、管理者、作成日時を含む、ワークスペースの一覧と詳細。
* **メンバー：** ロールでフィルタリングしたり、名前、ユーザー名、メールアドレスで検索したりできる、アカウントおよびワークスペースのメンバーシップ。
* **プロジェクト：** 公開範囲やデプロイメントステータスでフィルタリングしたり、タイトル、スラッグ、説明で検索したりできる、チームワークスペース全体のプロジェクト。

APIレスポンスはカーソルページネーションをサポートし、レート制限ヘッダーとリクエスト追跡用の`X-Request-Id`を含みます。

## Replit Agentで構築する

Replit AgentにAdmin APIを使ったカスタムダッシュボードの構築を依頼できます。ワークスペース別の使用状況やプロジェクト別のコストなど、追跡したいアカウントデータを説明すれば、AgentがダッシュボードとそのAPI統合を構築します。

<Steps>
  <Step title="スキルピッカーを開く">
    Replitプロジェクトで、チャット入力欄の横にある\*\*+\*\*ボタンをクリックし、**スキルを使用**を選択します。
  </Step>

  <Step title="Admin APIスキルを選択する">
    **Replitスキル**の下で**Admin API**を選択し、AgentにAPIのコンテキストと統合ガイダンスを提供します。
  </Step>

  <Step title="ダッシュボードを説明する">
    追跡したい内容とその表示方法をAgentに伝えます。例えば、ワークスペース別の使用状況とプロジェクト別のコストを示すダッシュボードの構築を依頼します。
  </Step>

  <Step title="APIキーを安全に追加する">
    AgentがAPIリクエストを行う必要がある場合、Admin APIキーをプロジェクトのSecretsに追加します。キーをチャットに貼り付けたり、プロジェクトにコミットしたりしないでください。
  </Step>
</Steps>

## APIリファレンス

エンドポイントの詳細、リクエストパラメータ、統合例については、[Admin API開発者ドキュメント](https://api.replit.com/docs)を参照してください。