平素よりmicroCMSをご利用いただき、誠にありがとうございます。
 
この度、2026年3月30日（月）に予定しておりますマネジメントAPIのアップデートで、サービスに所属しているメンバーの一覧を取得できるAPIが追加されます。
このリリースにより、既存APIキーにおける操作範囲が拡張されますので、仕様変更のお知らせをいたします。

アップデート内容

今回のアップデートでは、マネジメントAPIにメンバー一覧取得APIを追加します。
以下はレスポンス例です。

{
   "members": [
       {
           "id": "xxx",
           "name": "メンバー",
           "email": "member@example.com",
           "mfa": true,
           "inviting": false
       },
       {
           // ...
       }
   ],
   "totalCount": 120,
   "token": "xxx"
}

アップデートに伴う仕様変更

メンバー一覧取得APIの追加により、これまでよりもAPIキーを利用して取得できるメンバー情報の範囲が広がります。
これまでは、メンバーの詳細情報を取得するには対象メンバーのIDを把握している必要がありましたが、今後は該当権限が付与されたAPIキーにアクセスできる場合、メンバー一覧を取得できるようになります。

【変更前】

• 「メンバー詳細情報の取得」権限を付与したAPIキーで、API経由で各メンバーの詳細情報（表示名、メールアドレス、2要素認証の設定状況）を取得できます。

• ただし、情報取得に必要なメンバーIDは、対象メンバーの閲覧権限を持つメンバーが管理画面などから取得しておく必要があります。

【変更後】

• APIキーの権限名を「メンバー詳細情報の取得」から「メンバーの取得 (一覧・詳細)」に変更し、メンバー一覧の取得も同権限で可能となります。
• 上記の変更により、該当権限が付与されたAPIキーにアクセスできる場合、権限管理で閲覧が制限されているメンバーの情報も取得可能となります。

推奨される対応

マネジメントAPIの「メンバー詳細情報の取得」権限を付与したAPIキーの利用がない場合は、対応は不要です。

APIキーの利用がある場合は、APIキーにアクセスできるメンバーが、サービスに所属するメンバーの一覧（表示名、メールアドレスなど）を取得できる状態となっても問題がないか、ご確認ください。
問題がある場合は、該当のAPIキーに付与されている権限や、APIキーにアクセスできるメンバーを見直してください。

変更予定日

2026年3月30日（月） 
※ 不具合や想定外の事項があった場合、リリース日は変更となる可能性がございます。

本件に関するお問い合わせ先

本件に関してご不明点がございます場合は、お問い合わせフォームよりご連絡ください。

今後もより使いやすいサービスになるよう改善を続けてまいります。
今後とも、microCMSをご愛顧賜りますようお願い申し上げます。