관리자조직

Admin API

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

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

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

Admin API는 두 가지 자격 증명을 허용합니다: x-api-key 헤더로 전송되는 Admin API 키(sk-ant-admin...으로 시작) 또는 authorization: Bearer 헤더로 전송되는 org:admin 범위를 가진 OAuth 베어러 토큰입니다. admin 역할을 가진 조직 구성원만 Admin API 키를 프로비저닝할 수 있으며, admin, owner 또는 primary owner 역할을 가진 구성원만 org:admin 토큰을 얻을 수 있습니다. Admin API 키 생성을 참조하세요.

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

인증

두 자격 증명 중 하나로 인증합니다. 조직 유형에 맞는 Admin API 키를 생성하려면 Admin API 키 생성을 참조하세요. 다음 예제는 조직 정보 엔드포인트를 두 가지 방식으로 호출합니다:

OAuth 베어러:

cURL

curl --fail-with-body -sS "https://api.anthropic.com/v1/organizations/me" \
  --header "anthropic-version: 2023-06-01" \
  --header "authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"

org:admin 토큰은 기반이 되는 프로필 또는 페더레이션 규칙이 바인딩된 워크스페이스와 관계없이 전체 조직에 대한 액세스 권한을 부여합니다. 토큰을 얻으려면 Admin API로 WIF 관리의 사전 요구 사항을 참조하세요.

Admin API 키:

cURL

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

Admin API 작동 방식

Admin API를 사용할 때:

인증 섹션의 자격 증명 중 하나를 사용하여 요청을 보냅니다
API를 통해 다음을 관리할 수 있습니다:
- 조직 구성원 및 역할
- 조직 구성원 초대
- 워크스페이스 및 구성원
- API 키
- 서비스 계정, 페더레이션 발급자 및 페더레이션 규칙(이러한 엔드포인트는 org:admin OAuth 토큰이 필요하며, Admin API 키는 허용되지 않습니다)

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

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

조직 역할 및 권한

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

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

조직 owner와 primary owner는 모든 admin 권한을 가지며 추가로 admin을 관리할 수 있습니다. 이 페이지에서 admin 역할에 대한 모든 언급은 owner와 primary owner에게도 적용됩니다.

주요 개념

조직 구성원

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

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

서비스 계정

Workload Identity Federation 토큰이 대행하는 비인간 ID인 서비스 계정(svac_...)을 생성하고 관리합니다. 서비스 계정, 페더레이션 발급자 또는 페더레이션 규칙 엔드포인트에서는 Admin API 키가 허용되지 않으므로 org:admin OAuth 토큰을 사용하세요. Admin API로 WIF 관리를 참조하세요.

페더레이션 발급자

조직의 워크로드 ID를 주장할 수 있는 토큰을 발급하는 OIDC ID 공급자(fdis_...)를 등록합니다. Admin API로 WIF 관리를 참조하세요.

페더레이션 규칙

발급자 토큰을 서비스 계정 및 범위에 매핑하는 규칙(fdrl_...)을 관리합니다. Admin API로 WIF 관리를 참조하세요.

조직 정보 액세스

/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는 특별한 액세스 권한이 필요합니다

인증

OAuth 베어러:

cURL

curl --fail-with-body -sS "https://api.anthropic.com/v1/organizations/me" \
  --header "anthropic-version: 2023-06-01" \
  --header "authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"

Admin API 키:

cURL

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

Admin API 작동 방식

Admin API를 사용할 때:

인증 섹션의 자격 증명 중 하나를 사용하여 요청을 보냅니다
API를 통해 다음을 관리할 수 있습니다:
- 조직 구성원 및 역할
- 조직 구성원 초대
- 워크스페이스 및 구성원
- API 키
- 서비스 계정, 페더레이션 발급자 및 페더레이션 규칙(이러한 엔드포인트는 org:admin OAuth 토큰이 필요하며, Admin 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"
  }'

서비스 계정

페더레이션 발급자

조직의 워크로드 ID를 주장할 수 있는 토큰을 발급하는 OIDC ID 공급자(fdis_...)를 등록합니다. Admin API로 WIF 관리를 참조하세요.

페더레이션 규칙

발급자 토큰을 서비스 계정 및 범위에 매핑하는 규칙(fdrl_...)을 관리합니다. Admin API로 WIF 관리를 참조하세요.

조직 정보 액세스

/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을 제거할 수 있나요?

조직 초대는 얼마나 오래 유지되나요?

인증

Admin API 작동 방식

조직 역할 및 권한

주요 개념

조직 구성원

조직 초대

워크스페이스

워크스페이스 구성원

API 키

서비스 계정

페더레이션 발급자

페더레이션 규칙

조직 정보 액세스

사용량 및 비용 보고서

Claude Code 분석

속도 제한

Compliance API

모범 사례

FAQ

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

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

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

API를 통해 조직 admin을 제거할 수 있나요?

조직 초대는 얼마나 오래 유지되나요?

인증

Admin API 작동 방식

조직 역할 및 권한

주요 개념

조직 구성원

조직 초대

워크스페이스

워크스페이스 구성원

API 키

서비스 계정

페더레이션 발급자

페더레이션 규칙

조직 정보 액세스

사용량 및 비용 보고서

Claude Code 분석

속도 제한

Compliance API

모범 사례

FAQ

인증

Admin API 작동 방식

조직 역할 및 권한

주요 개념

조직 구성원

조직 초대

워크스페이스

워크스페이스 구성원

API 키

서비스 계정

페더레이션 발급자

페더레이션 규칙

조직 정보 액세스

사용량 및 비용 보고서

Claude Code 분석

속도 제한

Compliance API

모범 사례

FAQ