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 memungkinkan Anda mengelola sumber daya organisasi secara programatis, termasuk anggota organisasi, workspace, dan kunci API. Ini menyediakan kontrol programatis atas tugas administratif yang sebaliknya memerlukan konfigurasi manual di Claude Console.
Admin API memerlukan akses khususAdmin API memerlukan kunci Admin API khusus (dimulai dengan sk-ant-admin...) yang berbeda dari kunci API standar. Hanya anggota organisasi dengan peran admin yang dapat menyediakan kunci Admin API melalui Claude Console.

​
Cara kerja Admin API

Ketika Anda menggunakan Admin API:
  1. Anda membuat permintaan menggunakan kunci Admin API Anda di header x-api-key
  2. API memungkinkan Anda mengelola:
    • Anggota organisasi dan peran mereka
    • Undangan anggota organisasi
    • Workspace dan anggota mereka
    • Kunci API
Ini berguna untuk:
  • Mengotomatisasi onboarding/offboarding pengguna
  • Mengelola akses workspace secara programatis
  • Memantau dan mengelola penggunaan kunci API

​
Peran dan izin organisasi

Ada lima peran tingkat organisasi. Lihat detail lebih lanjut di sini.
PeranIzin
userDapat menggunakan Workbench
claude_code_userDapat menggunakan Workbench dan Claude Code
developerDapat menggunakan Workbench dan mengelola kunci API
billingDapat menggunakan Workbench dan mengelola detail penagihan
adminDapat melakukan semua hal di atas, plus mengelola pengguna

​
Konsep kunci

​
Anggota Organisasi

Anda dapat membuat daftar anggota organisasi, memperbarui peran anggota, dan menghapus anggota. 
# Daftar anggota organisasi
curl "https://api.anthropic.com/v1/organizations/users?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

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

# Hapus anggota
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"

​
Undangan Organisasi

Anda dapat mengundang pengguna ke organisasi dan mengelola undangan tersebut. 
# Buat undangan
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"
  }'

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

# Hapus undangan
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"

​
Workspace

Buat dan kelola workspace (console) untuk mengorganisir sumber daya Anda: 
# Buat workspace
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"}'

# Daftar workspace
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"

# Arsipkan workspace
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"

​
Anggota Workspace

Kelola akses pengguna ke workspace tertentu: 
# Tambahkan anggota ke workspace
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"
  }'

# Daftar anggota workspace
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"

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

# Hapus anggota dari workspace
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"

​
Kunci API

Pantau dan kelola kunci API: 
# Daftar kunci 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"

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

​
Mengakses informasi organisasi

Dapatkan informasi tentang organisasi Anda secara programatis dengan endpoint /v1/organizations/me. Sebagai contoh: 
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"
}
Endpoint ini berguna untuk menentukan secara programatis organisasi mana yang dimiliki oleh kunci Admin API. Untuk detail parameter lengkap dan skema respons, lihat referensi API Informasi Organisasi.

​
Mengakses laporan penggunaan dan biaya

Untuk mengakses laporan penggunaan dan biaya untuk organisasi Anda, gunakan endpoint API Penggunaan dan Biaya:
  • Endpoint Penggunaan (/v1/organizations/usage_report/messages) menyediakan data penggunaan terperinci, termasuk jumlah token dan metrik permintaan, dikelompokkan berdasarkan berbagai dimensi seperti workspace, pengguna, dan model.
  • Endpoint Biaya (/v1/organizations/cost_report) menyediakan data biaya yang terkait dengan penggunaan organisasi Anda, memungkinkan Anda melacak pengeluaran dan mengalokasikan biaya berdasarkan workspace atau deskripsi.
Endpoint ini memberikan wawasan terperinci tentang penggunaan organisasi Anda dan biaya terkait.

​
Mengakses analitik Claude Code

Untuk organisasi yang menggunakan Claude Code, API Analitik Claude Code menyediakan metrik produktivitas terperinci dan wawasan penggunaan:
  • Endpoint Analitik Claude Code (/v1/organizations/usage_report/claude_code) menyediakan metrik agregat harian untuk penggunaan Claude Code, termasuk sesi, baris kode, commit, pull request, statistik penggunaan alat, dan data biaya yang dipecah berdasarkan pengguna dan model.
API ini memungkinkan Anda melacak produktivitas pengembang, menganalisis adopsi Claude Code, dan membangun dashboard kustom untuk organisasi Anda.

​
Praktik terbaik

Untuk menggunakan Admin API secara efektif:
  • Gunakan nama dan deskripsi yang bermakna untuk workspace dan kunci API
  • Implementasikan penanganan kesalahan yang tepat untuk operasi yang gagal
  • Audit peran dan izin anggota secara berkala
  • Bersihkan workspace yang tidak digunakan dan undangan yang kedaluwarsa
  • Pantau penggunaan kunci API dan rotasi kunci secara berkala

​
FAQ

Hanya anggota organisasi dengan peran admin yang dapat menggunakan Admin API. Mereka juga harus memiliki kunci Admin API khusus (dimulai dengan sk-ant-admin).
Tidak, kunci API baru hanya dapat dibuat melalui Claude Console untuk alasan keamanan. Admin API hanya dapat mengelola kunci API yang sudah ada.
Kunci API tetap dalam keadaan saat ini karena mereka terikat pada Organisasi, bukan pada pengguna individual.
Tidak, anggota organisasi dengan peran admin tidak dapat dihapus melalui API untuk alasan keamanan.
Undangan organisasi kedaluwarsa setelah 21 hari. Saat ini tidak ada cara untuk mengubah periode kedaluwarsa ini.
Ya, Anda dapat memiliki maksimal 100 workspace per Organisasi. Workspace yang diarsipkan tidak dihitung dalam batas ini.
Setiap Organisasi memiliki “Default Workspace” yang tidak dapat diedit atau dihapus, dan tidak memiliki ID. Workspace ini tidak muncul dalam endpoint daftar workspace.
Admin organisasi secara otomatis mendapat peran workspace_admin ke semua workspace. Anggota penagihan organisasi secara otomatis mendapat peran workspace_billing. Pengguna dan pengembang organisasi harus ditambahkan secara manual ke setiap workspace.
Pengguna dan pengembang organisasi dapat ditetapkan peran workspace_admin, workspace_developer, atau workspace_user. Peran workspace_billing tidak dapat ditetapkan secara manual - itu diwarisi dari memiliki peran organisasi billing.
Hanya anggota penagihan organisasi yang dapat memiliki peran workspace mereka ditingkatkan ke peran admin. Selain itu, admin organisasi dan anggota penagihan tidak dapat memiliki peran workspace mereka diubah atau dihapus dari workspace selama mereka memegang peran organisasi tersebut. Akses workspace mereka harus dimodifikasi dengan mengubah peran organisasi mereka terlebih dahulu.
Jika admin organisasi atau anggota penagihan diturunkan ke pengguna atau pengembang, mereka kehilangan akses ke semua workspace kecuali yang mereka diberi peran secara manual. Ketika pengguna dipromosikan ke peran admin atau penagihan, mereka mendapat akses otomatis ke semua workspace.