# APIキーの管理

APIキーを使用すると、外部ツールや自動化処理がワークスペースとプログラムで連携できます。ワークスペース管理者は、いつでもキーを作成、表示、失効できます。

### APIキーの作成

次へ移動し、 **設定 → API → キー** をクリックします **新しいAPIキー**。キーには、後で識別できるよう、説明的な名前（例：「CI/CD連携」または「社内ダッシュボード」）を付けてください。

{% hint style="warning" %}
作成後は、すぐにキーをコピーしてください。一度しか表示されません。紛失した場合は、失効して再作成する必要があります。
{% endhint %}

### キーの権限

キー作成時に、権限の範囲を設定できます。

| 権限       | 許可される内容             |
| -------- | ------------------- |
| **読み取り** | コンテンツ、設定、メンバーデータの取得 |
| **書き込み** | コンテンツの作成と更新         |
| **管理者**  | 設定、メンバー、請求の管理       |

各連携に必要最小限の権限のみを使用してください。

### キーのローテーション

キーをローテーションするには、新しいキーを作成し、連携を更新してそのキーを使用するようにしたうえで、古いキーを失効させます。自動ローテーションはありません。手動での作業になります。

### キーの失効

次へ移動し、 **設定 → API → キー**、キーを見つけて、 **失効**をクリックしてください。失効は即時に反映され、そのキーを使用するすべてのリクエストは直ちに失敗します。

### 使用状況のモニタリング

以下で **設定 → API → 使用状況**では、過去30日間のキーごとのリクエスト数を確認できます。これは、想定外の使用を把握したり、どの連携が最も活発かを特定したりするのに有用です。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://isbm.savimbo.com/practice-guide/ja/guan-li-zhe/apikno.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.