AdminOrganisasi

Admin API

Admin API tidak tersedia untuk akun individu. Untuk berkolaborasi dengan rekan tim dan menambahkan anggota, atur organisasi Anda di Console → Settings → Organization.

Admin API memungkinkan Anda mengelola sumber daya organisasi Anda secara terprogram, termasuk anggota organisasi, workspace, dan kunci API. Ini memberikan kontrol terprogram atas tugas-tugas administratif yang jika tidak akan 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.

Claude Platform di AWS: Sebagian besar Admin API tidak tersedia di Claude Platform di AWS. Endpoint workspace (create, get, list, update, dan archive pada /v1/organizations/workspaces) tersedia. Endpoint lainnya termasuk anggota organisasi, anggota workspace, undangan, kunci API, laporan penggunaan, laporan biaya, dan laporan batas laju tidak tersedia. Lihat Claude Platform di AWS untuk detailnya.

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
- Workspace dan anggotanya
- Kunci API

Ini berguna untuk:

Mengotomatiskan onboarding/offboarding pengguna
Mengelola akses workspace secara terprogram
Memantau dan mengelola penggunaan kunci API

Peran dan izin organisasi

Ada lima peran tingkat organisasi. Lihat detail lebih lanjut di artikel Peran dan izin API Console.

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, ditambah mengelola pengguna

Konsep utama

Anggota Organisasi

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

cURL

# Menampilkan 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"

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

# Menghapus 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.

cURL

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

# 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

Untuk panduan komprehensif tentang workspace, termasuk contoh Console dan API, lihat Workspace.

Anggota Workspace

Kelola akses pengguna ke workspace tertentu:

cURL

# Tambahkan anggota ke workspace
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"
  }'

# 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 "content-type: application/json" \
  --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:

cURL

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

Mengakses info organisasi

Dapatkan informasi tentang organisasi Anda secara terprogram dengan endpoint /v1/organizations/me.

Sebagai contoh:

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

Endpoint ini berguna untuk menentukan secara terprogram organisasi mana yang terkait dengan kunci Admin API.

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

Laporan penggunaan dan biaya

Lacak penggunaan dan biaya organisasi Anda dengan Usage and Cost API.

Analitik Claude Code

Pantau produktivitas developer dan adopsi Claude Code dengan Claude Code Analytics API.

Batas laju

Baca batas laju yang dikonfigurasi untuk organisasi Anda dan workspace-nya dengan Rate Limits API.

Compliance API

Ambil data audit dan aktivitas untuk organisasi Anda dengan Compliance API. Kunci Admin API hanya dapat membaca Activity Feed; untuk akses penuh, lihat Mendapatkan akses ke Compliance API.

Praktik terbaik

Untuk menggunakan Admin API secara efektif:

Gunakan nama dan deskripsi yang bermakna untuk workspace dan kunci API
Terapkan 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

Untuk pertanyaan khusus workspace, lihat FAQ Workspace.

Was this page helpful?

AdminOrganisasi

Admin API

Admin API tidak tersedia untuk akun individu. Untuk berkolaborasi dengan rekan tim dan menambahkan anggota, atur organisasi Anda di 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
- Workspace dan anggotanya
- Kunci API

Ini berguna untuk:

Mengotomatiskan onboarding/offboarding pengguna
Mengelola akses workspace secara terprogram
Memantau dan mengelola penggunaan kunci API

Peran dan izin organisasi

Ada lima peran tingkat organisasi. Lihat detail lebih lanjut di artikel Peran dan izin API Console.

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, ditambah mengelola pengguna

Konsep utama

Anggota Organisasi

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

cURL

# Menampilkan 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"

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

# Menghapus 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.

cURL

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

# 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

Untuk panduan komprehensif tentang workspace, termasuk contoh Console dan API, lihat Workspace.

Anggota Workspace

Kelola akses pengguna ke workspace tertentu:

cURL

# Tambahkan anggota ke workspace
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"
  }'

# 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 "content-type: application/json" \
  --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:

cURL

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

Mengakses info organisasi

Dapatkan informasi tentang organisasi Anda secara terprogram dengan endpoint /v1/organizations/me.

Sebagai contoh:

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

Endpoint ini berguna untuk menentukan secara terprogram organisasi mana yang terkait dengan kunci Admin API.

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

Laporan penggunaan dan biaya

Lacak penggunaan dan biaya organisasi Anda dengan Usage and Cost API.

Analitik Claude Code

Pantau produktivitas developer dan adopsi Claude Code dengan Claude Code Analytics API.

Batas laju

Baca batas laju yang dikonfigurasi untuk organisasi Anda dan workspace-nya dengan Rate Limits API.

Compliance API

Ambil data audit dan aktivitas untuk organisasi Anda dengan Compliance API. Kunci Admin API hanya dapat membaca Activity Feed; untuk akses penuh, lihat Mendapatkan akses ke Compliance API.

Praktik terbaik

Untuk menggunakan Admin API secara efektif:

Gunakan nama dan deskripsi yang bermakna untuk workspace dan kunci API
Terapkan 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

Untuk pertanyaan khusus workspace, lihat FAQ Workspace.

Was this page helpful?

Cara kerja Admin API

Peran dan izin organisasi

Konsep utama

Anggota Organisasi

Undangan Organisasi

Workspace

Anggota Workspace

Kunci API

Mengakses info organisasi

Laporan penggunaan dan biaya

Analitik Claude Code

Batas laju

Compliance API

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 berlaku?

Cara kerja Admin API

Peran dan izin organisasi

Konsep utama

Anggota Organisasi

Undangan Organisasi

Workspace

Anggota Workspace

Kunci API

Mengakses info organisasi

Laporan penggunaan dan biaya

Analitik Claude Code

Batas laju

Compliance API

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 berlaku?