The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.

Admin API를 사용하면 조직 구성원, 워크스페이스 및 API 키를 포함한 조직의 리소스를 프로그래밍 방식으로 관리할 수 있습니다. 이를 통해 Anthropic 콘솔에서 수동 구성이 필요한 관리 작업을 프로그래밍 방식으로 제어할 수 있습니다.

Admin API는 특별한 접근 권한이 필요합니다

Admin API는 표준 API 키와 다른 특별한 Admin API 키(sk-ant-admin...으로 시작)가 필요합니다. 관리자 역할을 가진 조직 구성원만 Anthropic 콘솔을 통해 Admin API 키를 프로비저닝할 수 있습니다.

​
Admin API 작동 방식

Admin API를 사용할 때:

  1. x-api-key 헤더에 Admin API 키를 사용하여 요청합니다
  2. API를 통해 다음을 관리할 수 있습니다:
    • 조직 구성원 및 역할
    • 조직 구성원 초대
    • 워크스페이스 및 구성원
    • API 키

이는 다음과 같은 용도로 유용합니다:

  • 사용자 온보딩/오프보딩 자동화
  • 프로그래밍 방식으로 워크스페이스 접근 관리
  • API 키 사용량 모니터링 및 관리

​
조직 역할 및 권한

조직 수준에는 다섯 가지 역할이 있습니다.

역할권한
userWorkbench 사용 가능
claude_code_userWorkbench 및 Claude Code 사용 가능
developerWorkbench 사용 및 API 키 관리 가능
billingWorkbench 사용 및 결제 세부 정보 관리 가능
admin위의 모든 작업 가능, 사용자 관리 포함

​
주요 개념

​
조직 구성원

조직 구성원을 나열하고, 구성원 역할을 업데이트하고, 구성원을 제거할 수 있습니다.

# 조직 구성원 나열
curl "https://api.anthropic.com/v1/organizations/users?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# 구성원 역할 업데이트
curl "https://api.anthropic.com/v1/organizations/users/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"role": "developer"}'

# 구성원 제거
curl --request DELETE "https://api.anthropic.com/v1/organizations/users/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

​
조직 초대

사용자를 조직에 초대하고 해당 초대를 관리할 수 있습니다.

# 초대 생성
curl --request POST "https://api.anthropic.com/v1/organizations/invites" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "email": "newuser@domain.com",
    "role": "developer"
  }'

# 초대 나열
curl "https://api.anthropic.com/v1/organizations/invites?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# 초대 삭제
curl --request DELETE "https://api.anthropic.com/v1/organizations/invites/{invite_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

​
워크스페이스

리소스를 구성하기 위한 워크스페이스를 생성하고 관리합니다:

# 워크스페이스 생성
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"name": "Production"}'

# 워크스페이스 나열
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# 워크스페이스 보관
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

​
워크스페이스 구성원

특정 워크스페이스에 대한 사용자 접근 관리:

# 워크스페이스에 구성원 추가
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# 워크스페이스 구성원 나열
curl "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# 구성원 역할 업데이트
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "workspace_role": "workspace_admin"
  }'

# 워크스페이스에서 구성원 제거
curl --request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

​
API 키

API 키 모니터링 및 관리:

# API 키 나열
curl "https://api.anthropic.com/v1/organizations/api_keys?limit=10&status=active&workspace_id=wrkspc_xxx" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# API 키 업데이트
curl --request POST "https://api.anthropic.com/v1/organizations/api_keys/{api_key_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "status": "inactive",
    "name": "New Key Name"
  }'

​
모범 사례

Admin API를 효과적으로 사용하기 위한 방법:

  • 워크스페이스 및 API 키에 의미 있는 이름과 설명 사용
  • 실패한 작업에 대한 적절한 오류 처리 구현
  • 정기적으로 구성원 역할 및 권한 감사
  • 사용하지 않는 워크스페이스 및 만료된 초대 정리
  • API 키 사용량 모니터링 및 정기적인 키 교체

​
FAQ