관리자조직

Admin API

Admin API는 개인 계정에서는 사용할 수 없습니다. 팀원과 협업하고 멤버를 추가하려면 Console → Settings → Organization에서 조직을 설정하세요.

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

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

Admin API는 표준 API 키와 다른 특별한 Admin API 키(sk-ant-admin...으로 시작)가 필요합니다. admin 역할을 가진 조직 구성원만 Claude Console을 통해 Admin API 키를 발급할 수 있습니다.

AWS 기반 Claude Platform: Admin API의 대부분은 AWS 기반 Claude Platform에서 사용할 수 없습니다. 워크스페이스 엔드포인트(/v1/organizations/workspaces에 대한 생성, 조회, 목록, 업데이트, 보관)는 사용할 수 있습니다. 조직 구성원, 워크스페이스 구성원, 초대, API 키, 사용량 보고서, 비용 보고서, 속도 제한 보고서를 포함한 다른 엔드포인트는 사용할 수 없습니다. 자세한 내용은 AWS 기반 Claude Platform을 참조하세요.

Admin API 작동 방식

Admin API를 사용할 때:

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

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

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

조직 역할 및 권한

조직 수준의 역할은 다섯 가지가 있습니다. 자세한 내용은 API Console 역할 및 권한 문서를 참조하세요.

역할	권한
user	Workbench 사용 가능
claude_code_user	Workbench 및 Claude Code 사용 가능
developer	Workbench 사용 및 API 키 관리 가능
billing	Workbench 사용 및 결제 정보 관리 가능
admin	위의 모든 작업 및 사용자 관리 가능

주요 개념

조직 구성원

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

cURL

# 조직 멤버 목록 조회
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 "content-type: application/json" \
  --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

# 초대 생성
curl --request POST "https://api.anthropic.com/v1/organizations/invites" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --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 예제를 포함한 워크스페이스에 대한 종합 가이드는 워크스페이스를 참조하세요.

워크스페이스 구성원

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

cURL

# 워크스페이스에 멤버 추가
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --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 "content-type: application/json" \
  --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 키를 모니터링하고 관리하세요:

cURL

# 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 "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "status": "inactive",
    "name": "New Key Name"
  }'

조직 정보 접근

/v1/organizations/me 엔드포인트를 사용하여 조직에 대한 정보를 프로그래밍 방식으로 가져올 수 있습니다.

예시:

cURL

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

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

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

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

사용량 및 비용 보고서

Usage and Cost API를 사용하여 조직의 사용량과 비용을 추적하세요.

Claude Code 분석

Claude Code Analytics API를 사용하여 개발자 생산성과 Claude Code 도입 현황을 모니터링하세요.

속도 제한

Rate Limits API를 사용하여 조직 및 워크스페이스에 구성된 속도 제한을 확인하세요.

Compliance API

Compliance API를 사용하여 조직의 감사 및 활동 데이터를 조회하세요. Admin API 키는 Activity Feed만 읽을 수 있습니다. 전체 접근 권한은 Compliance API 접근 권한 얻기를 참조하세요.

모범 사례

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

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

FAQ

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

Was this page helpful?

관리자조직

Admin API

Admin API는 개인 계정에서는 사용할 수 없습니다. 팀원과 협업하고 멤버를 추가하려면 Console → Settings → Organization에서 조직을 설정하세요.

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

Admin API 작동 방식

Admin API를 사용할 때:

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

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

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

조직 역할 및 권한

조직 수준의 역할은 다섯 가지가 있습니다. 자세한 내용은 API Console 역할 및 권한 문서를 참조하세요.

역할	권한
user	Workbench 사용 가능
claude_code_user	Workbench 및 Claude Code 사용 가능
developer	Workbench 사용 및 API 키 관리 가능
billing	Workbench 사용 및 결제 정보 관리 가능
admin	위의 모든 작업 및 사용자 관리 가능

주요 개념

조직 구성원

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

cURL

# 조직 멤버 목록 조회
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 "content-type: application/json" \
  --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

# 초대 생성
curl --request POST "https://api.anthropic.com/v1/organizations/invites" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --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 예제를 포함한 워크스페이스에 대한 종합 가이드는 워크스페이스를 참조하세요.

워크스페이스 구성원

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

cURL

# 워크스페이스에 멤버 추가
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --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 "content-type: application/json" \
  --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 키를 모니터링하고 관리하세요:

cURL

# 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 "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "status": "inactive",
    "name": "New Key Name"
  }'

조직 정보 접근

/v1/organizations/me 엔드포인트를 사용하여 조직에 대한 정보를 프로그래밍 방식으로 가져올 수 있습니다.

예시:

cURL

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

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

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

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

사용량 및 비용 보고서

Usage and Cost API를 사용하여 조직의 사용량과 비용을 추적하세요.

Claude Code 분석

Claude Code Analytics API를 사용하여 개발자 생산성과 Claude Code 도입 현황을 모니터링하세요.

속도 제한

Rate Limits API를 사용하여 조직 및 워크스페이스에 구성된 속도 제한을 확인하세요.

Compliance API

모범 사례

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

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

FAQ

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

Was this page helpful?

Admin API 작동 방식

조직 역할 및 권한

주요 개념

조직 구성원

조직 초대

워크스페이스

워크스페이스 구성원

API 키

조직 정보 접근

사용량 및 비용 보고서

Claude Code 분석

속도 제한

Compliance API

모범 사례

FAQ

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

Admin API를 통해 새 API 키를 생성할 수 있나요?

사용자를 제거하면 API 키는 어떻게 되나요?

API를 통해 조직 관리자를 제거할 수 있나요?

조직 초대는 얼마나 유효한가요?

Admin API 작동 방식

조직 역할 및 권한

주요 개념

조직 구성원

조직 초대

워크스페이스

워크스페이스 구성원

API 키

조직 정보 접근

사용량 및 비용 보고서

Claude Code 분석

속도 제한

Compliance API

모범 사례

FAQ

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

Admin API를 통해 새 API 키를 생성할 수 있나요?

사용자를 제거하면 API 키는 어떻게 되나요?

API를 통해 조직 관리자를 제거할 수 있나요?

조직 초대는 얼마나 유효한가요?