組織、ユーザー、ロール、グループ、設定の一覧取得

このページのエンドポイントは、Claude Enterprise組織のディレクトリ側を公開します。つまり、リンクされた組織、各組織内のユーザー、各組織で定義されたロール、そして「role-based access control」（ロールベースアクセス制御）、すなわちRBAC、または「SCIM (System for Cross-domain Identity Management)」でプロビジョニングされたグループとそのメンバーです。これらを使用して、eDiscoveryのユーザーリストのシード作成、レポートダッシュボードの構築、外部の記録システムに対するグループメンバーシップの照合を行えます。親組織をカバーするCompliance Access Keyは、その配下にあるすべてのリンクされた組織のデータを返すため、単一のキーでツリー全体にアクセスできます。有効設定エンドポイントはディレクトリを補完するもので、1つの組織に対して実際に適用されているデータプライバシー、セキュリティ、機能の設定を返します。



組織の一覧取得

List organizationsエンドポイントは、キーがバインドされている親組織配下のすべての組織を返します。

次の呼び出しは、親組織配下のすべての組織を一覧表示します。レスポンスは、created_atの昇順でソートされた組織レコードのdata配列と、ページネーション用のhas_moreおよびnext_pageです。has_moreがtrueの場合、返されたnext_pageトークンを変更せずに、次のリクエストのpageクエリパラメータとして渡します。limitおよびpageパラメータのデフォルト値と範囲については、APIリファレンスのList organizationsを参照してください。

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/organizations" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
      "name": "Acme Engineering",
      "created_at": "2025-06-01T10:00:00Z"
    },
    {
      "uuid": "5a1b2c3d-4e5f-6789-abcd-ef0123456789",
      "name": "Acme Legal",
      "created_at": "2025-07-15T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

uuidフィールドは、後続のルックアップにおける正規の識別子です。次の表は、Compliance API全体における他の組織識別子との対応を示しています。

他のほとんどのAnthropic APIは、org_プレフィックス付きの形式を使用します。

組織メンバーシップの変更を経時的に追跡するには、このエンドポイントを定期的に再取得し、各実行でnext_pageトークンをたどってすべてのページを取得します。Activity Feedも、org_deletion_requested、org_deleted_via_bulk、org_parent_join_proposal_created、org_join_proposal_decidedのアクティビティタイプを通じてメンバーシップイベントを表示します。Activity Feedのクエリを参照してください。



組織ユーザーの一覧取得

List organization usersエンドポイントは、1つの組織のユーザーレコードのページネーションされたリストを返します。

このエンドポイントには、read:compliance_org_dataではなくread:compliance_user_dataが必要です。ディレクトリの列挙に使用する予定がある場合は、両方のスコープを持つCompliance Access Keyを作成してください。そうでない場合、呼び出しは403 Forbiddenを返します。

limitおよびpageクエリパラメータのデフォルト値と範囲については、APIリファレンスのList organization usersを参照してください。

結果は組織への参加日の昇順でソートされます。Activity Feedのbefore_id/after_idカーソル（結果のページネーションを参照）とは異なり、ディレクトリエンドポイントはnext_pageトークンでページネーションします。has_moreがtrueの場合、next_pageを変更せずに次のリクエストのpageクエリパラメータとして渡します。

org_uuid="91012d09-e48b-438e-a489-1bebfd8fa6f9"

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/organizations/$org_uuid/users" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --data-urlencode "limit=500"

{
  "data": [
    {
      "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
      "full_name": "Priya Sharma",
      "email": "[email protected]",
      "organization_role": "admin",
      "created_at": "2025-06-01T10:00:00Z"
    }
  ],
  "has_more": true,
  "next_page": "page_8aW5kZXgicG9zaXRpb25fdG9rZW5fOTE0"
}

ここで返されるユーザーIDは、Activity Feedのクエリのactor_ids[]フィルター、およびチャットとメッセージの取得のuser_ids[]フィルターで受け入れられるものと同じuser_...識別子です。organization_roleフィールドは、一覧表示された組織内でのユーザーの組み込みメンバーシップレベル（admin、billing、claude_code_user、developer、managed、membership_admin、owner、primary_owner、userのいずれか）を示し、これはロールの一覧取得で返されるカスタムRBACロール割り当てとは独立した軸です。典型的なeDiscoveryフローでは、1つ以上の組織のユーザーを一覧表示し、自社の外部レコードと照合してフィルタリングし、結果のIDをチャットおよびプロジェクトのクエリに渡します。

ユーザーは、組織のアクティブなメンバーである間のみここに表示されます。削除されたユーザーは直ちにリストから除外されます。その過去のアクティビティは、同じuser_... IDでインデックス付けされ、保持期間全体にわたってActivity Feedを通じてクエリ可能なままです。



ロールの一覧取得

List Compliance Rolesエンドポイントは、1つの組織で定義されたロールレコードのページネーションされたリストを返し、Get Compliance RoleはIDで1つのロールを返します。

両方のロールエンドポイントにはread:compliance_org_dataが必要です。一覧エンドポイントは、組織ユーザーエンドポイントと同じlimitおよびpageパラメータを受け入れます。

org_uuid="91012d09-e48b-438e-a489-1bebfd8fa6f9"

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/organizations/${org_uuid}/roles" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "id": "rbac_role_01N2pQrS8tUvWxYz5AbCdEfGh",
      "name": "Compliance Reviewer",
      "description": "Read-only access to chat and project content for legal review.",
      "created_at": "2025-06-01T10:00:00Z",
      "updated_at": "2025-06-15T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

ロールレコードの完全な形式については、List Compliance Rolesのレスポンススキーマを参照してください。ロールに現在付与されている権限を一覧表示するには、List Compliance Role Permissionsを使用します。過去のロール割り当てと権限の変更を監査するには、Activity Feedを通じてRBACアクティビティタイプ（例：rbac_role_assignedやrbac_role_permission_added）をクエリします。アクティビティのフィルタリングを参照してください。



グループとメンバーの一覧取得

List Compliance Groupsエンドポイントは、RBACおよびSCIMでプロビジョニングされたグループのページネーションされたリストを返し、Get Compliance GroupはIDで1つのグループを返します。List Compliance Group Membersエンドポイントは、1つのグループのメンバーを返します。

グループの一覧および取得エンドポイントにはread:compliance_org_dataが必要です。メンバーエンドポイントにはread:compliance_user_dataが必要です。グループを端から端まで走査するには、両方のスコープを持つキーを作成してください。両方の一覧エンドポイントは、組織ユーザーエンドポイントと同じlimitおよびpageパラメータを受け入れます。

グループレコードの完全な形式については、List Compliance Groupsのレスポンススキーマを参照してください。roles配列は、グループに割り当てられたロールIDを一覧表示し、ロールの一覧取得のIDと一致します。source_typeは、claude.aiを通じて手動で作成されたグループ（direct）と、SCIMを通じて外部のアイデンティティプロバイダーから同期されたグループ（scim）を区別する識別子です。

グループを一覧表示し、次に各グループのメンバーを一覧表示します。

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/groups" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "id": "rbac_group_01P9qRsTuVwXyZa2BcDeFgHjK",
      "name": "Engineering",
      "description": "Engineering team members",
      "source_type": "scim",
      "roles": ["rbac_role_01N2pQrS8tUvWxYz5AbCdEfGh"],
      "created_at": "2025-06-01T10:00:00Z",
      "updated_at": "2025-06-15T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

各グループIDについて、そのメンバーを一覧表示します。

group_id="rbac_group_01P9qRsTuVwXyZa2BcDeFgHjK"

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/groups/$group_id/members" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "user_id": "user_01XyDMpzjS89pFZXqSFUBDr6",
      "email": "[email protected]",
      "created_at": "2025-06-01T10:00:00Z",
      "updated_at": "2025-06-15T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

メンバーレコードの完全な形式については、List Compliance Group Membersのレスポンススキーマを参照してください。user_idフィールドは、Activity Feedとチャット一覧が受け入れるものと同じuser_...識別子です。メンバーのフルネームを取得するには、組織ユーザー一覧で検索してください。



有効な組織設定の取得

Get effective organization settingsエンドポイントは、親組織配下の1つの組織に対して適用されている設定を返します。これは、規制上の制限（HIPAAなど）、機能の利用可否ルール、組織タイプのデフォルト、機能間の依存関係が適用された後の強制状態であり、管理者が構成した内容とは異なる場合があります。これを使用して、管理者のConsoleアクセスなしに、保持期間、コンテンツの編集（リダクション）、シングルサインオンの強制、IP許可リスト、セッション期間の制御が文書化されたベースラインと一致していることを証明できます。

このエンドポイントにはread:compliance_org_dataが必要です。そのスコープを持たないキーは403 Forbiddenを返します。対象は親組織のリンクされた組織のいずれかである必要があり、親組織自体は有効な対象ではありません。不明な組織、有効なUUIDではない組織ID、親組織のツリー外の組織、このエンドポイントへのアクセス権をまだ持っていない親組織は、すべて同じ404 Not Foundを返すため、404は組織が存在するかどうかを明らかにしません。設定エンドポイントは、Compliance APIの他の部分とは別に、親組織ごとに有効化されます。すべてのリクエストが404を返す場合は、Anthropicの担当者にお問い合わせください。

org_uuid="91012d09-e48b-438e-a489-1bebfd8fa6f9"

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/organizations/$org_uuid/settings" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

レスポンスは型付けされた設定行のリストであり、どの行が表示されるかは組織によって異なります。Anthropicのポリシーによって制御されている、または組織で利用できないために組織の管理者が変更できない設定は、リストから省略されます。欠落している行は「オフ」ではなく、「この組織の管理者が制御できない」として扱ってください。次の省略された例は、レスポンスに含まれ得る行のうち3つを示しています。

{
  "type": "effective_organization_settings",
  "organization_id": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
  "settings": [
    {
      "name": "data_retention_periods",
      "type": "data_retention",
      "value": {
        "chat": {
          "type": "fixed",
          "timescale": "day",
          "duration": 90
        }
      }
    },
    {
      "name": "content_redaction_enabled",
      "type": "boolean",
      "value": true
    },
    {
      "name": "ip_allowlist_ip_ranges",
      "type": "string_list",
      "value": ["10.0.0.0/8", "203.0.113.0/24"]
    }
  ],
  "api_keys": [
    {
      "type": "compliance_api_key",
      "id": "apikey_01Hx7k2mP9nQ4rS6tU8vW0xY",
      "name": "Compliance Export Key",
      "scopes": ["read:compliance_activities", "read:compliance_org_data"],
      "is_active": true,
      "created_at": "2026-03-14T09:30:00Z",
      "created_by_id": "user_01Jz3a4bC5dE6fG7hI8jK9lM",
      "expires_at": null
    }
  ]
}

各行はname、type、valueを持ちます。typeフィールド（boolean、integer、string_list、provisioning_mode、またはdata_retention）はvalueの形式を示します。設定名の完全なリストと各タイプのvalueスキーマは、APIリファレンスのGet effective organization settingsにあります。

api_keys配列は、親組織に構成されたすべてのCompliance Access Keyを一覧表示するため、どのリンクされた組織をクエリしても同じリストが返されます。各エントリには、キーのtype（compliance_api_key）、id、name、scopes、is_activeフラグ、created_atおよびexpires_atタイムスタンプ、created_by_id（キーを作成したユーザーのID。nullの場合があります）が含まれます。キーのシークレット値が返されることはありません。無効化されたキーはis_active: falseとして含まれるため、以前にアクセス権を持っていたキーを確認できます。また、廃止されたread:compliance_org_settingsスコープのみを持つキーは、そのスコープがもはやアクセスを許可しないにもかかわらず、監査とクリーンアップの可視性のためにリストに残ります。

トップレベルのorganization_idは、組織のプレフィックスなしのUUIDです。これは組織一覧のuuidと同じ値であり、Activity Feed、チャット、プロジェクトのレコードでorganization_idが持つorg_プレフィックス付きの形式ではありません（組織識別子の表を参照）。

行は、最後に保存された構成ではなく、強制された状態を反映します。たとえば、sso_provisioning_modeはディレクトリ同期が有効な間のみ構成されたSCIMモードを報告し、ip_allowlist_enabledは許可リストがオンで少なくとも1つのアクティブな範囲がある間のみtrueになり、code_execution_network_egress_enabledはコード実行がオフの場合は常にfalseになります。

レスポンスは読み取り時点の状態を反映し、スナップショットは作成されません。これらの設定のほとんどの変更は、Activity Feedにイベントとして表示されます。現在の解決済み状態にはこのエンドポイントを使用し、誰がいつ何を変更したかを監査するにはフィードを使用してください。



次のステップ