Administrasi dan pemantauan

Ikhtisar Admin API

Kelola sumber daya organisasi Anda secara terprogram dengan Admin API, termasuk anggota organisasi, ruang kerja, dan kunci 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 memungkinkan Anda mengelola sumber daya organisasi Anda secara terprogram, termasuk anggota organisasi, ruang kerja, dan kunci API. Ini memberikan kontrol terprogram atas tugas administratif yang sebaliknya memerlukan konfigurasi manual di Claude Console.

Admin API memerlukan akses khusus

Admin 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

Saat Anda menggunakan Admin API:

Anda membuat permintaan menggunakan kunci Admin API Anda di header x-api-key
API memungkinkan Anda mengelola:
- Anggota organisasi dan peran mereka
- Undangan anggota organisasi
- Ruang kerja dan anggotanya
- Kunci API

Ini berguna untuk:

Mengotomatisasi onboarding/offboarding pengguna
Mengelola akses ruang kerja secara terprogram
Memantau dan mengelola penggunaan kunci API

Peran dan izin organisasi

Ada lima peran tingkat organisasi. Lihat detail selengkapnya di sini.

Peran	Izin
user	Dapat menggunakan Workbench
claude_code_user	Dapat menggunakan Workbench dan Claude Code
developer	Dapat menggunakan Workbench dan mengelola kunci API
billing	Dapat menggunakan Workbench dan mengelola detail penagihan
admin	Dapat melakukan semua hal di atas, plus mengelola pengguna

Konsep kunci

Anggota Organisasi

Anda dapat membuat daftar anggota organisasi, memperbarui peran anggota, dan menghapus anggota.

Shell

# List organization members
curl "https://api.anthropic.com/v1/organizations/users?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

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

# Remove member
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.

Shell

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

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

# Delete invite
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"

Ruang Kerja

Buat dan kelola ruang kerja (konsol) untuk mengorganisir sumber daya Anda:

Shell

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

# List workspaces
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"

# Archive 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 Ruang Kerja

Kelola akses pengguna ke ruang kerja tertentu:

Shell

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

# List workspace members
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"

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

# Remove member from 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:

Shell

# List API keys
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"

# Update API key
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 terprogram 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 terprogram organisasi mana yang dimiliki kunci Admin API.

Untuk detail parameter lengkap dan skema respons, lihat referensi Organization Info API.

Mengakses laporan penggunaan dan biaya

Untuk mengakses laporan penggunaan dan biaya untuk organisasi Anda, gunakan endpoint Usage and Cost API:

Endpoint Penggunaan (/v1/organizations/usage_report/messages) menyediakan data penggunaan terperinci, termasuk jumlah token dan metrik permintaan, dikelompokkan menurut berbagai dimensi seperti ruang kerja, 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 ruang kerja atau deskripsi.

Endpoint ini memberikan wawasan terperinci tentang penggunaan organisasi Anda dan biaya terkait.

Mengakses analitik Claude Code

Untuk organisasi yang menggunakan Claude Code, Claude Code Analytics API menyediakan metrik produktivitas terperinci dan wawasan penggunaan:

Endpoint Claude Code Analytics (/v1/organizations/usage_report/claude_code) menyediakan metrik agregat harian untuk penggunaan Claude Code, termasuk sesi, baris kode, komit, permintaan tarik, statistik penggunaan alat, dan data biaya yang dipecah menurut pengguna dan model.

API ini memungkinkan Anda melacak produktivitas pengembang, menganalisis adopsi Claude Code, dan membangun dasbor khusus untuk organisasi Anda.

Praktik terbaik

Untuk menggunakan Admin API secara efektif:

Gunakan nama dan deskripsi yang bermakna untuk ruang kerja dan kunci API
Terapkan penanganan kesalahan yang tepat untuk operasi yang gagal
Audit secara teratur peran dan izin anggota
Bersihkan ruang kerja yang tidak digunakan dan undangan yang kedaluwarsa
Pantau penggunaan kunci API dan putar kunci secara berkala

FAQ

Administrasi dan pemantauan

Ikhtisar Admin API

Kelola sumber daya organisasi Anda secara terprogram dengan Admin API, termasuk anggota organisasi, ruang kerja, dan kunci 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 memerlukan akses khusus

Cara kerja Admin API

Saat Anda menggunakan Admin API:

Anda membuat permintaan menggunakan kunci Admin API Anda di header x-api-key
API memungkinkan Anda mengelola:
- Anggota organisasi dan peran mereka
- Undangan anggota organisasi
- Ruang kerja dan anggotanya
- Kunci API

Ini berguna untuk:

Mengotomatisasi onboarding/offboarding pengguna
Mengelola akses ruang kerja secara terprogram
Memantau dan mengelola penggunaan kunci API

Peran dan izin organisasi

Ada lima peran tingkat organisasi. Lihat detail selengkapnya di sini.

Peran	Izin
user	Dapat menggunakan Workbench
claude_code_user	Dapat menggunakan Workbench dan Claude Code
developer	Dapat menggunakan Workbench dan mengelola kunci API
billing	Dapat menggunakan Workbench dan mengelola detail penagihan
admin	Dapat melakukan semua hal di atas, plus mengelola pengguna

Konsep kunci

Anggota Organisasi

Anda dapat membuat daftar anggota organisasi, memperbarui peran anggota, dan menghapus anggota.

Shell

# List organization members
curl "https://api.anthropic.com/v1/organizations/users?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

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

# Remove member
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.

Shell

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

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

# Delete invite
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"

Ruang Kerja

Buat dan kelola ruang kerja (konsol) untuk mengorganisir sumber daya Anda:

Shell

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

# List workspaces
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"

# Archive 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 Ruang Kerja

Kelola akses pengguna ke ruang kerja tertentu:

Shell

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

# List workspace members
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"

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

# Remove member from 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:

Shell

# List API keys
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"

# Update API key
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 terprogram 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 terprogram organisasi mana yang dimiliki kunci Admin API.

Untuk detail parameter lengkap dan skema respons, lihat referensi Organization Info API.

Mengakses laporan penggunaan dan biaya

Untuk mengakses laporan penggunaan dan biaya untuk organisasi Anda, gunakan endpoint Usage and Cost API:

Endpoint Penggunaan (/v1/organizations/usage_report/messages) menyediakan data penggunaan terperinci, termasuk jumlah token dan metrik permintaan, dikelompokkan menurut berbagai dimensi seperti ruang kerja, 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 ruang kerja atau deskripsi.

Endpoint ini memberikan wawasan terperinci tentang penggunaan organisasi Anda dan biaya terkait.

Mengakses analitik Claude Code

Untuk organisasi yang menggunakan Claude Code, Claude Code Analytics API menyediakan metrik produktivitas terperinci dan wawasan penggunaan:

Endpoint Claude Code Analytics (/v1/organizations/usage_report/claude_code) menyediakan metrik agregat harian untuk penggunaan Claude Code, termasuk sesi, baris kode, komit, permintaan tarik, statistik penggunaan alat, dan data biaya yang dipecah menurut pengguna dan model.

API ini memungkinkan Anda melacak produktivitas pengembang, menganalisis adopsi Claude Code, dan membangun dasbor khusus untuk organisasi Anda.

Praktik terbaik

Untuk menggunakan Admin API secara efektif:

Gunakan nama dan deskripsi yang bermakna untuk ruang kerja dan kunci API
Terapkan penanganan kesalahan yang tepat untuk operasi yang gagal
Audit secara teratur peran dan izin anggota
Bersihkan ruang kerja yang tidak digunakan dan undangan yang kedaluwarsa
Pantau penggunaan kunci API dan putar kunci secara berkala

Cara kerja Admin API

Peran dan izin organisasi

Konsep kunci

Anggota Organisasi

Undangan Organisasi

Ruang Kerja

Anggota Ruang Kerja

Kunci API

Mengakses informasi organisasi

Mengakses laporan penggunaan dan biaya

Mengakses analitik Claude Code

Praktik terbaik

FAQ

Izin apa yang diperlukan untuk menggunakan Admin API?

Bisakah saya membuat kunci API baru melalui Admin API?

Apa yang terjadi pada kunci API saat menghapus pengguna?

Bisakah admin organisasi dihapus melalui API?

Berapa lama undangan organisasi berlangsung?

Apakah ada batasan pada ruang kerja?

Apa itu Ruang Kerja Default?

Bagaimana peran organisasi mempengaruhi akses Ruang Kerja?

Peran mana yang dapat ditetapkan di ruang kerja?

Bisakah peran ruang kerja admin atau anggota penagihan organisasi diubah?

Apa yang terjadi pada akses ruang kerja saat peran organisasi berubah?

Cara kerja Admin API

Peran dan izin organisasi

Konsep kunci

Anggota Organisasi

Undangan Organisasi

Ruang Kerja

Anggota Ruang Kerja

Kunci API

Mengakses informasi organisasi

Mengakses laporan penggunaan dan biaya

Mengakses analitik Claude Code

Praktik terbaik

FAQ

Izin apa yang diperlukan untuk menggunakan Admin API?

Bisakah saya membuat kunci API baru melalui Admin API?

Apa yang terjadi pada kunci API saat menghapus pengguna?

Bisakah admin organisasi dihapus melalui API?

Berapa lama undangan organisasi berlangsung?

Apakah ada batasan pada ruang kerja?

Apa itu Ruang Kerja Default?

Bagaimana peran organisasi mempengaruhi akses Ruang Kerja?

Peran mana yang dapat ditetapkan di ruang kerja?

Bisakah peran ruang kerja admin atau anggota penagihan organisasi diubah?

Apa yang terjadi pada akses ruang kerja saat peran organisasi berubah?