Admin API 개요

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 키 등)를 프로그래밍 방식으로 관리할 수 있습니다. 이를 통해 Claude Console에서 수동으로 구성해야 하는 관리 작업을 프로그래밍 방식으로 제어할 수 있습니다.

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

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

Admin API 작동 방식

Admin API를 사용할 때:

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

이는 다음과 같은 경우에 유용합니다:

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

조직 역할 및 권한

5가지 조직 수준 역할이 있습니다. API Console 역할 및 권한 문서에서 자세한 내용을 확인하세요.

역할	권한
user	Workbench 사용 가능
claude_code_user	Workbench 및 Claude Code 사용 가능
developer	Workbench 사용 및 API 키 관리 가능
billing	Workbench 사용 및 청구 세부정보 관리 가능
admin	위의 모든 작업 수행 가능, 추가로 사용자 관리 가능

주요 개념

조직 멤버

조직 멤버를 나열하고, 멤버 역할을 업데이트하고, 멤버를 제거할 수 있습니다.

Shell

# 조직 멤버 나열
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"

조직 초대

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

Shell

# 초대 생성
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": "[email protected]",
    "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"

워크스페이스

Console 및 API 예제를 포함한 워크스페이스에 대한 포괄적인 가이드는 워크스페이스를 참조하세요.

워크스페이스 멤버

특정 워크스페이스에 대한 사용자 액세스를 관리합니다:

Shell

# 워크스페이스에 멤버 추가
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 키를 모니터링하고 관리합니다:

Shell

# 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"
  }'

조직 정보 액세스

/v1/organizations/me 엔드포인트를 사용하여 조직 정보를 프로그래밍 방식으로 가져옵니다.

예를 들어:

curl "https://api.anthropic.com/v1/organizations/me" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

{
  "id": "12345678-1234-5678-1234-567812345678",
  "type": "organization",
  "name": "Organization Name"
}

이 엔드포인트는 Admin API 키가 속한 조직을 프로그래밍 방식으로 확인하는 데 유용합니다.

전체 매개변수 세부정보 및 응답 스키마는 조직 정보 API 참조를 참조하세요.

사용량 및 비용 보고서

사용량 및 비용 API를 사용하여 조직의 사용량 및 비용을 추적합니다.

Claude Code 분석

Claude Code Analytics API를 사용하여 개발자 생산성 및 Claude Code 채택을 모니터링합니다.

모범 사례

Admin API를 효과적으로 사용하려면:

워크스페이스 및 API 키에 의미 있는 이름과 설명을 사용합니다
실패한 작업에 대한 적절한 오류 처리를 구현합니다
멤버 역할 및 권한을 정기적으로 감시합니다
사용하지 않는 워크스페이스 및 만료된 초대를 정리합니다
API 키 사용량을 모니터링하고 주기적으로 키를 회전합니다

FAQ

워크스페이스 관련 질문은 워크스페이스 FAQ를 참조하세요.

Admin API 작동 방식

조직 역할 및 권한

주요 개념

조직 멤버

조직 초대

워크스페이스

워크스페이스 멤버

API 키

조직 정보 액세스

사용량 및 비용 보고서

Claude Code 분석

모범 사례

FAQ

Admin API를 사용하려면 어떤 권한이 필요합니까?

Admin API를 통해 새 API 키를 생성할 수 있습니까?

사용자를 제거할 때 API 키는 어떻게 됩니까?

조직 관리자를 API를 통해 제거할 수 있습니까?

조직 초대는 얼마나 오래 유지됩니까?