使用者管理

本頁涵蓋如何使用 Admin API 以程式化方式管理您的 Claude Enterprise（claude.ai）組織中的人員：列出成員並透過電子郵件地址查詢、變更成員的角色、移除成員、傳送和撤回邀請、管理您企業的群組及其成員資格，以及讀取您組織的自訂角色。如需 Claude Console（Claude Platform）組織的相關資訊，請參閱 Claude Console 的 Admin API 指南。



您的組織可以使用哪些端點？

Admin API 是位於 https://api.anthropic.com/v1/organizations/ 下的單一組端點。Claude Console 和 Claude Enterprise 組織使用不同的金鑰進行驗證，且各自可存取不同的端點子集：

成員和邀請對兩種組織類型而言是相同的端點；本頁記錄它們在 Claude Enterprise 中的行為，包括 Claude Enterprise 的組織角色。群組和自訂角色端點僅存在於 Claude Enterprise。



概觀

本頁涵蓋五種資源：

自訂角色及其群組附加關係是在 claude.ai 組織設定中管理的；API 可以讀取它們但無法變更。



快速開始

列出組織的成員，最新的排在最前面：

curl "https://api.anthropic.com/v1/organizations/users?limit=20" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

{
  "data": [
    {
      "type": "user",
      "id": "user_01AbCdEfGhIjKlMnOpQrSt",
      "email": "[email protected]",
      "name": "Jane Smith",
      "role": "user",
      "added_at": "2026-06-12T09:14:03Z"
    }
  ],
  "has_more": false,
  "first_id": "user_01AbCdEfGhIjKlMnOpQrSt",
  "last_id": "user_01AbCdEfGhIjKlMnOpQrSt"
}



關鍵概念



組織角色

每位成員都恰好有一個組織角色。讀取時會以下列五個值之一回傳成員的角色：

API 只能在建立邀請和更新角色時指派 user 和 managed 角色。管理性角色（owner、membership_admin 和 primary_owner）是在 claude.ai 組織設定中指派的，持有這些角色的成員無法透過此 API 修改或移除。



成員和邀請

一個人透過接受邀請（或透過您組織的單一登入，若已設定）成為成員。建立邀請會傳送一封邀請電子郵件；該邀請隨後會顯示為 pending，直到收件者接受（accepted）或其伺服器指派的 expires_at 過期（expired）。只有 pending 狀態的邀請可以被撤回。若要變更待處理邀請的電子郵件地址或角色，請撤回它並建立新的邀請。

如果您組織的方案是從有限的已購買席次池中分配成員，待處理的邀請會佔用一個席次。建立邀請的端點不接受席次或層級參數：席次會自動從有可用席次的最低層級中指派。在沒有可用席次時建立邀請會失敗並回傳 400 錯誤，而不會購買席次。撤回邀請、讓其過期，或之後移除該成員，都會將席次歸還到席次池。



群組和角色

群組將成員連結到自訂角色（基於角色的存取控制，即端點路徑和範圍名稱中的 rbac）。群組由您的整個企業（母組織連同其下的每個組織）擁有，而非由單一組織擁有，因此群組範圍（read:rbac_groups 和 write:rbac_groups）需要為所有已連結組織建立的金鑰。每個群組都帶有一個 source_type：direct 表示在 claude.ai 中建立的群組，scim 表示由您的身分提供者佈建的群組。群組的 roles 欄位列出附加到該群組的自訂角色 ID；請使用自訂角色端點將它們解析為名稱和權限，並注意角色目錄是以組織為單位的，而群組是企業範圍的，因此擷取屬於您企業中其他組織的角色時，您的金鑰會收到 404。當角色資料暫時無法取得時，該欄位為 null（而非 []），因此請重試以區分降級的讀取與沒有角色的群組。



速率限制

Admin API 端點共用每個組織 每分鐘 100 個請求 的限制；邀請建立則有自己的限制，為 每小時 1,200 個請求。超過限制的請求會回傳 429 Too Many Requests。



分頁

成員和邀請清單使用基於 ID 的分頁：傳遞 limit（預設 20，最大 1000）加上最多一個 before_id 或 after_id，並使用每個回應的 first_id 和 last_id 欄位進行分頁，直到 has_more 為 false。群組和自訂角色清單則使用不透明游標：回應的 next_page 值會原封不動地作為下一個請求的 page 參數傳遞，直到 next_page 為 null。



錯誤回應

錯誤回應遵循錯誤中記錄的標準格式。



成員



列出成員

GET /v1/organizations/users 回傳組織的成員，最近新增的排在最前面。透過 email 篩選以查詢特定成員；比對不區分大小寫，並容許同一地址的常見變體（例如，[email protected] 會比對到 [email protected]）。需要 read:members 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的列出使用者。

curl "https://api.anthropic.com/v1/organizations/[email protected]" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"



取得成員

GET /v1/organizations/users/{user_id} 透過 ID 回傳一位成員。需要 read:members 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的取得使用者。

curl "https://api.anthropic.com/v1/organizations/users/user_01AbCdEfGhIjKlMnOpQrSt" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"



變更成員的角色

POST /v1/organizations/users/{user_id} 將成員的角色設定為 user 或 managed。持有管理性角色（owner、membership_admin 或 primary_owner）的成員無法透過此端點變更，且無法指派管理性角色；兩者都會回傳 400，並且是在 claude.ai 組織設定中管理的。如果您組織的身分提供者管理角色（進階 SSO 或進階 SCIM 佈建），角色更新會回傳 400。需要 write:members 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的更新使用者。

curl -X POST "https://api.anthropic.com/v1/organizations/users/user_01AbCdEfGhIjKlMnOpQrSt" \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"role": "managed"}'



移除成員

DELETE /v1/organizations/users/{user_id} 將成員從組織中移除，並將其佔用的任何已購買席次歸還到組織的席次池。持有管理性角色的成員無法透過此端點移除，且如果您的身分提供者管理成員資格（SCIM），移除操作會回傳 400。需要 write:members 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的移除使用者。

curl -X DELETE "https://api.anthropic.com/v1/organizations/users/user_01AbCdEfGhIjKlMnOpQrSt" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

{
  "type": "user_deleted",
  "id": "user_01AbCdEfGhIjKlMnOpQrSt"
}



邀請



建立邀請

POST /v1/organizations/invites 傳送一封邀請電子郵件，並回傳帶有伺服器指派的 expires_at 的邀請。role 必須是 user 或 managed。如果該電子郵件地址已存在待處理的邀請，或該地址已屬於某位成員，請求會回傳 400 並指出現有的資源。身分提供者自動佈建使用者（JIT 或 SCIM）的組織無法透過 API 建立邀請。需要 write:members 範圍。

在從有限席次池分配成員的方案中，邀請會自動從有可用席次的最低層級中取得一個席次；API 不接受層級參數。如果沒有可用席次，請求會失敗並回傳 400 錯誤，而不會購買席次。請透過組織的方案管理新增席次後重試。

選用的 rbac_group_ids 欄位列出在成員接受邀請時要指派給該成員的群組（以 rbac_group_ 為前綴的 ID）。傳遞非空的 rbac_group_ids 還需要金鑰帶有 write:rbac_groups 範圍，因為群組指派可以授予附加到該群組角色的權限。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的建立邀請。

curl -X POST "https://api.anthropic.com/v1/organizations/invites" \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "email": "[email protected]",
    "role": "managed",
    "rbac_group_ids": ["rbac_group_01UvWxYzAbCdEfGhIjKlMn"]
  }'

{
  "type": "invite",
  "id": "invite_01QrStUvWxYzAbCdEfGhIj",
  "email": "[email protected]",
  "role": "managed",
  "invited_at": "2026-07-06T16:20:11Z",
  "expires_at": "2026-07-27T16:20:11Z",
  "accepted_at": null,
  "status": "pending",
  "rbac_group_ids": ["rbac_group_01UvWxYzAbCdEfGhIjKlMn"]
}



列出邀請

GET /v1/organizations/invites 回傳組織的邀請，最近的排在最前面，涵蓋 pending、accepted 和 expired 狀態；沒有狀態篩選器。需要 read:members 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的列出邀請。

curl "https://api.anthropic.com/v1/organizations/invites?limit=20" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"



取得邀請

GET /v1/organizations/invites/{invite_id} 透過 ID 回傳一個邀請。需要 read:members 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的取得邀請。

curl "https://api.anthropic.com/v1/organizations/invites/invite_01QrStUvWxYzAbCdEfGhIj" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"



撤回邀請

DELETE /v1/organizations/invites/{invite_id} 撤回 pending 狀態的邀請，使邀請電子郵件中的連結失效。撤回 accepted 狀態的邀請會回傳 400（請改為移除該成員）；撤回 expired 狀態的邀請會回傳 400。需要 write:members 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的刪除邀請。

curl -X DELETE "https://api.anthropic.com/v1/organizations/invites/invite_01QrStUvWxYzAbCdEfGhIj" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"



群組

您的企業直接建立的群組（在 claude.ai 組織設定中或透過此 API 建立，source_type: "direct"）支援本節中的每個端點。由您的身分提供者佈建的群組（source_type: "scim"）可以讀取但無法修改：重新命名或刪除 SCIM 群組，或變更其成員資格，會回傳 400，因為該群組由您的身分提供者擁有。每個群組請求都必須包含 anthropic-beta: ce-user-management-2026-07-13 標頭，如範例所示；未包含此標頭的請求會回傳 404。與成員和邀請請求不同，群組請求不需要 anthropic-version 標頭。



列出群組

GET /v1/organizations/rbac_groups 回傳您企業的群組，包括由身分提供者管理的（scim）群組。需要 read:rbac_groups 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的列出群組。

curl "https://api.anthropic.com/v1/organizations/rbac_groups?limit=20" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-beta: ce-user-management-2026-07-13"

{
  "data": [
    {
      "type": "rbac_group",
      "id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
      "name": "Engineering",
      "source_type": "direct",
      "roles": ["rbac_role_01CdEfGhIjKlMnOpQrStUv"],
      "created_at": "2026-03-18T10:01:42Z",
      "updated_at": "2026-05-02T08:55:09Z"
    }
  ],
  "has_more": false,
  "next_page": null
}



取得群組

GET /v1/organizations/rbac_groups/{group_id} 透過 ID 回傳一個群組。需要 read:rbac_groups 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的取得群組。

curl "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-beta: ce-user-management-2026-07-13"



建立群組

POST /v1/organizations/rbac_groups 使用給定的 name（1–255 個字元）建立一個沒有角色或成員的群組。需要 write:rbac_groups 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的建立群組。

curl -X POST "https://api.anthropic.com/v1/organizations/rbac_groups" \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-beta: ce-user-management-2026-07-13" \
  -d '{"name": "Engineering"}'

{
  "type": "rbac_group",
  "id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
  "name": "Engineering",
  "source_type": "direct",
  "roles": [],
  "created_at": "2026-07-09T18:00:00Z",
  "updated_at": "2026-07-09T18:00:00Z"
}



重新命名群組

POST /v1/organizations/rbac_groups/{group_id} 更新群組。name 是此端點唯一可以變更的欄位。需要 write:rbac_groups 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的更新群組。

curl -X POST "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn" \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-beta: ce-user-management-2026-07-13" \
  -d '{"name": "Platform Engineering"}'



刪除群組

DELETE /v1/organizations/rbac_groups/{group_id} 刪除群組。其成員仍然是其組織的成員，但他們會失去附加角色的權限，且群組的支出限制（如果存在）將不再適用於他們。需要 write:rbac_groups 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的刪除群組。

curl -X DELETE "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-beta: ce-user-management-2026-07-13"

{
  "id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
  "type": "rbac_group_deleted"
}



列出群組的成員

GET /v1/organizations/rbac_groups/{group_id}/members 回傳群組的成員（每位成員包含其 user_id 和電子郵件），最早的排在最前面。只會回傳您企業組織的目前成員，因此某一頁可能包含少於 limit 的項目，而 has_more 為 true。需要 read:rbac_groups 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的列出群組成員。

curl "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn/members?limit=100" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-beta: ce-user-management-2026-07-13"

{
  "data": [
    {
      "type": "rbac_group_member",
      "group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
      "user_id": "user_01AbCdEfGhIjKlMnOpQrSt",
      "email": "[email protected]",
      "created_at": "2026-04-07T12:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}



將成員新增到群組

POST /v1/organizations/rbac_groups/{group_id}/members 透過 user_id 將組織成員新增到群組。該使用者必須已經是您企業某個組織的成員（否則請求會回傳 404），而新增已在群組中的人會回傳 400。對於 scim 群組，成員資格是在您的身分提供者中管理的，此請求會回傳 400。若要將群組指派給尚未加入的人，請改為在建立邀請時使用 rbac_group_ids。需要 write:rbac_groups 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的新增群組成員。

curl -X POST "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn/members" \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-beta: ce-user-management-2026-07-13" \
  -d '{"user_id": "user_01AbCdEfGhIjKlMnOpQrSt"}'

{
  "type": "rbac_group_member",
  "group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
  "user_id": "user_01AbCdEfGhIjKlMnOpQrSt",
  "email": "[email protected]",
  "created_at": "2026-07-09T18:00:00Z"
}



從群組中移除成員

DELETE /v1/organizations/rbac_groups/{group_id}/members/{user_id} 將成員從群組中移除；他們仍然是其組織的成員。如果該使用者不是群組的成員，請求會回傳 404；對於 scim 群組（其成員資格是在您的身分提供者中管理的），會回傳 400。需要 write:rbac_groups 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的移除群組成員。

curl -X DELETE "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn/members/user_01AbCdEfGhIjKlMnOpQrSt" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-beta: ce-user-management-2026-07-13"

{
  "group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
  "user_id": "user_01AbCdEfGhIjKlMnOpQrSt",
  "type": "rbac_group_member_deleted"
}



自訂角色

自訂角色透過 API 是唯讀的：這些端點列出您組織的自訂角色（在 claude.ai 組織設定中定義或由 Anthropic 佈建）以及每個角色授予的權限。自訂角色的讀取使用 read:members 範圍（沒有獨立的角色範圍），並可使用組織層級的金鑰：與群組端點不同，它們不需要為所有已連結組織建立的金鑰，且回傳的目錄是您組織自己的。自訂角色請求與群組請求一樣，必須包含 anthropic-beta: ce-user-management-2026-07-13 標頭；未包含此標頭的請求會回傳 404。



列出角色

GET /v1/organizations/rbac_roles 回傳您組織的自訂角色。需要 read:members 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的列出角色。

curl "https://api.anthropic.com/v1/organizations/rbac_roles?limit=20" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-beta: ce-user-management-2026-07-13"

{
  "data": [
    {
      "type": "rbac_role",
      "id": "rbac_role_01CdEfGhIjKlMnOpQrStUv",
      "name": "Engineering base",
      "created_at": "2026-03-18T10:01:42Z",
      "updated_at": "2026-05-02T08:55:09Z"
    }
  ],
  "has_more": false,
  "next_page": null
}



取得角色

GET /v1/organizations/rbac_roles/{role_id} 透過 ID 回傳一個角色。需要 read:members 範圍。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的取得角色。

curl "https://api.anthropic.com/v1/organizations/rbac_roles/rbac_role_01CdEfGhIjKlMnOpQrStUv" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-beta: ce-user-management-2026-07-13"



列出角色的權限

GET /v1/organizations/rbac_roles/{role_id}/permissions 回傳角色的權限。每個權限將一個 resource（其適用的對象：組織的產品功能、連接器工具、連接器 OAuth 範圍、一個連接器或所有連接器）與一個 action（其在該資源上授予的內容）配對。未為您的組織啟用的功能的列會被省略，因此某一頁可能包含少於 limit 的列，而 has_more 為 true。需要 read:members 範圍。

有兩個 action 值需要特別注意：action 為 capability_access_all（所有產品功能）或 capability_access_all_ga（所有正式發布的產品功能）的 organization 權限是一個概括性授權（不涵蓋模型存取，也不涵蓋以 permission_ 為前綴的管理面板權限），並以該單一列列出而不展開。當您統計角色授予的內容時，請將概括性的列視為涵蓋其變體所描述的所有內容，而不僅僅是其他列中指名的功能。

如需完整的參數詳細資訊和回應結構，請參閱 API 參考中的列出角色權限。

curl "https://api.anthropic.com/v1/organizations/rbac_roles/rbac_role_01CdEfGhIjKlMnOpQrStUv/permissions?limit=20" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-beta: ce-user-management-2026-07-13"

{
  "data": [
    {
      "type": "rbac_role_permission",
      "resource": {
        "type": "organization",
        "organization_id": "12345678-1234-5678-1234-567812345678"
      },
      "action": "capability_access_all_ga"
    },
    {
      "type": "rbac_role_permission",
      "resource": {
        "type": "connector_tool",
        "connector_id": "mcpsrv_01WxYzAbCdEfGhIjKlMnOp",
        "tool_name": "search_tickets"
      },
      "action": "use"
    }
  ],
  "has_more": false,
  "next_page": null
}



範例工作流程



為離職員工辦理離職手續

1. 透過電子郵件查詢成員：

   cURL

   

   curl "https://api.anthropic.com/v1/organizations/[email protected]" \
     -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
     -H "anthropic-version: 2023-06-01"

2. 使用回應中的 id，透過 DELETE /v1/organizations/users/{user_id} 移除他們。他們的席次（如果有）會歸還到席次池。

3. 如果該人員尚未加入，查詢不會回傳任何成員；請改為列出邀請並撤回其 pending 狀態的邀請。



稽核群組成員資格

1. 列出群組並記錄每個群組的 id、name 和 roles。

2. 對於每個帶有敏感角色的群組，透過 GET /v1/organizations/rbac_groups/{group_id}/members 逐頁瀏覽，並將成員電子郵件與您身分提供者的名冊進行比對。

3. 使用 DELETE /v1/organizations/rbac_groups/{group_id}/members/{user_id} 移除不應再屬於該群組的成員。對於 scim 群組，請改為在您的身分提供者中進行變更。



常見問題



這是與 Admin API 不同的 API 嗎？

不是。成員和邀請端點與 Claude Console 組織使用的 /v1/organizations/ 端點相同；本頁記錄它們在 Claude Enterprise 中的行為。群組和自訂角色端點是同一個 API 的一部分，且僅存在於 Claude Enterprise 組織。可用性表格顯示每種組織類型可以呼叫哪些端點。



我可以透過 API 指派擁有者或成員管理員角色嗎？

不可以。API 只能在建立邀請和更新角色時指派 user 和 managed。管理性角色是在 claude.ai 組織設定中指派的，持有這些角色的成員無法透過 API 修改或移除。



我可以透過 API 建立或修改群組嗎？

可以，使用 write:rbac_groups 範圍：建立、重新命名和刪除群組，以及新增或移除其成員。有兩件事是 API 無法變更的：由您的身分提供者佈建的群組（source_type: "scim"），其名稱和成員資格由身分提供者擁有；以及自訂角色，它們是在 claude.ai 組織設定中管理的（API 可以讀取它們）。



未被接受的邀請會佔用席次嗎？

在有有限席次池的方案中，會：pending 狀態的邀請會佔用一個席次。撤回邀請或讓其過期會釋放席次。在沒有席次池的方案中，邀請不會佔用任何資源。



我的組織使用單一登入。哪些操作可以運作？

如果您的身分提供者自動佈建使用者（JIT 或 SCIM），建立邀請會回傳 400。如果它管理角色（進階 SSO 或進階 SCIM 佈建），角色更新會回傳 400。如果它管理成員資格（SCIM 佈建），移除成員會回傳 400。無論如何，讀取操作都可以運作。



另請參閱