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 Console에서 수동 구성이 필요한 관리 작업을 프로그래밍 방식으로 제어할 수 있게 해줍니다.

Admin API는 특별한 액세스가 필요합니다

Admin API는 표준 API 키와 다른 특별한 Admin API 키(sk-ant-admin...으로 시작)가 필요합니다. 관리자 역할을 가진 조직 구성원만 Anthropic Console을 통해 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