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 menerima dua kredensial: kunci Admin API (dimulai dengan sk-ant-admin...) yang dikirim di header x-api-key atau token bearer OAuth dengan cakupan org:admin yang dikirim di header authorization: Bearer. Hanya anggota organisasi dengan peran admin yang dapat menyediakan kunci Admin API, dan hanya anggota dengan peran admin, owner, atau primary owner yang dapat memperoleh token org:admin. Lihat Membuat kunci Admin API.

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.

Autentikasi

Autentikasi dengan salah satu kredensial. Untuk membuat kunci Admin API untuk jenis organisasi Anda, lihat Membuat kunci Admin API. Contoh berikut memanggil endpoint info organisasi dengan kedua cara:

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

Token org:admin memberikan akses ke seluruh organisasi, terlepas dari workspace tempat profil atau aturan federasi yang mendasarinya terikat. Untuk memperolehnya, lihat prasyarat di Mengelola WIF dengan Admin API.

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

Cara kerja Admin API

Saat Anda menggunakan Admin API:

Anda membuat permintaan menggunakan salah satu kredensial dari bagian Autentikasi
API memungkinkan Anda untuk mengelola:
- Anggota organisasi dan peran mereka
- Undangan anggota organisasi
- Workspace dan anggotanya
- Kunci API
- Service account, federation issuer, dan federation rule (endpoint ini memerlukan token OAuth org:admin; kunci Admin API tidak diterima)

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 API Console roles and permissions.

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

Owner dan primary owner organisasi memiliki semua izin admin dan juga dapat mengelola admin. Semua referensi ke peran admin di halaman ini juga berlaku untuk owner dan primary owner.

Konsep utama

Anggota organisasi

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

cURL

# Mendaftar 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

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

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

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

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

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

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

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

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

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

Service account

Buat dan kelola service account (svac_...), identitas non-manusia yang diwakili oleh token Workload Identity Federation. Kunci Admin API tidak diterima pada endpoint service-account, federation-issuer, atau federation-rule; gunakan token OAuth org:admin. Lihat Mengelola WIF dengan Admin API.

Federation issuer

Daftarkan penyedia identitas OIDC (fdis_...) yang tokennya dapat menegaskan identitas workload untuk organisasi Anda. Lihat Mengelola WIF dengan Admin API.

Federation rule

Kelola aturan (fdrl_...) yang memetakan token issuer ke service account dan cakupan. Lihat Mengelola WIF dengan Admin API.

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 memiliki kunci Admin API tertentu.

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 "rate limit" (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 Menyiapkan 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

Autentikasi

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

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

Cara kerja Admin API

Saat Anda menggunakan Admin API:

Anda membuat permintaan menggunakan salah satu kredensial dari bagian Autentikasi
API memungkinkan Anda untuk mengelola:
- Anggota organisasi dan peran mereka
- Undangan anggota organisasi
- Workspace dan anggotanya
- Kunci API
- Service account, federation issuer, dan federation rule (endpoint ini memerlukan token OAuth org:admin; kunci Admin API tidak diterima)

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 API Console roles and permissions.

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

Owner dan primary owner organisasi memiliki semua izin admin dan juga dapat mengelola admin. Semua referensi ke peran admin di halaman ini juga berlaku untuk owner dan primary owner.

Konsep utama

Anggota organisasi

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

cURL

# Mendaftar 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

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

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

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

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

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

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

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

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

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

Service account

Federation issuer

Daftarkan penyedia identitas OIDC (fdis_...) yang tokennya dapat menegaskan identitas workload untuk organisasi Anda. Lihat Mengelola WIF dengan Admin API.

Federation rule

Kelola aturan (fdrl_...) yang memetakan token issuer ke service account dan cakupan. Lihat Mengelola WIF dengan Admin API.

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 memiliki kunci Admin API tertentu.

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 "rate limit" (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 Menyiapkan 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?

Autentikasi

Cara kerja Admin API

Peran dan izin organisasi

Konsep utama

Anggota organisasi

Undangan organisasi

Workspace

Anggota workspace

Kunci API

Service account

Federation issuer

Federation rule

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

Dapatkah saya membuat kunci API baru melalui Admin API?

Apa yang terjadi pada kunci API saat menghapus pengguna?

Dapatkah admin organisasi dihapus melalui API?

Berapa lama undangan organisasi berlaku?

Autentikasi

Cara kerja Admin API

Peran dan izin organisasi

Konsep utama

Anggota organisasi

Undangan organisasi

Workspace

Anggota workspace

Kunci API

Service account

Federation issuer

Federation rule

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

Dapatkah saya membuat kunci API baru melalui Admin API?

Apa yang terjadi pada kunci API saat menghapus pengguna?

Dapatkah admin organisasi dihapus melalui API?

Berapa lama undangan organisasi berlaku?

Autentikasi

Cara kerja Admin API

Peran dan izin organisasi

Konsep utama

Anggota organisasi

Undangan organisasi

Workspace

Anggota workspace

Kunci API

Service account

Federation issuer

Federation rule

Mengakses info organisasi

Laporan penggunaan dan biaya

Analitik Claude Code

Batas laju

Compliance API

Praktik terbaik

FAQ

Autentikasi

Cara kerja Admin API

Peran dan izin organisasi

Konsep utama

Anggota organisasi

Undangan organisasi

Workspace

Anggota workspace

Kunci API

Service account

Federation issuer

Federation rule

Mengakses info organisasi

Laporan penggunaan dan biaya

Analitik Claude Code

Batas laju

Compliance API

Praktik terbaik

FAQ