AdminOrganisasi

Admin API

Kelola anggota organisasi, workspace, undangan, dan kunci API secara terprogram dengan Admin API, menggunakan kunci Admin API atau token OAuth org:admin.

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. Hanya anggota organisasi dengan peran admin yang dapat membuatnya. Lihat Membuat kunci Admin API.
Token bearer OAuth dengan cakupan org:admin yang dikirim di header authorization: Bearer. Hanya anggota dengan peran admin, owner, atau primary owner yang dapat memperolehnya. Lihat Memperoleh token bearer OAuth.

Claude Enterprise: Organisasi Claude Enterprise (claude.ai) juga menggunakan Admin API, dengan kunci API bercakupan yang dibuat di claude.ai. Dari endpoint di halaman ini, hanya anggota dan undangan yang tersedia untuk mereka (dalam beta), bersama dengan endpoint khusus Claude Enterprise: grup dan pembacaan peran kustom (beta), serta batas pengeluaran. Lihat Manajemen pengguna untuk Claude Enterprise.

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. Kunci Admin API mencakup sebagian besar endpoint; endpoint service-account, federation-issuer, dan federation-rule hanya menerima token OAuth org:admin. Contoh berikut memanggil endpoint info organisasi dengan kedua cara.

Token bearer OAuth

Masuk dengan CLI ant di bawah profil khusus, dengan meminta cakupan org:admin (lihat Akses admin), lalu ekspor token bearer. Profil khusus menjaga perintah rutin Anda agar tidak berjalan dengan akses yang ditingkatkan:

CLI

ant auth login --profile admin --scope "org:admin"
export ANTHROPIC_OAUTH_TOKEN=$(ant auth print-credentials --profile admin --access-token)

Token interaktif berumur pendek; jika permintaan mulai mengembalikan 401, jalankan kembali perintah export, yang akan menyegarkan token secara otomatis.

Panggil Admin API dengan token yang telah diekspor:

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 yang mendasarinya atau aturan federasi terikat.

Untuk CI dan beban kerja non-interaktif lainnya, buat token dengan Workload Identity Federation alih-alih masuk secara interaktif. Lihat Mengelola WIF dengan Admin API.

Kunci Admin API

Untuk membuat kunci Admin API untuk jenis organisasi Anda, lihat Membuat 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 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

# Mencantumkan 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. Setiap kunci dalam respons menyertakan timestamp expires_at-nya (null untuk kunci tanpa kedaluwarsa):

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 beban kerja 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, audit expires_at setiap kunci, dan rotasi kunci secara berkala

FAQ

Untuk pertanyaan khusus workspace, lihat FAQ Workspace.

Was this page helpful?

AdminOrganisasi

Admin API

Kelola anggota organisasi, workspace, undangan, dan kunci API secara terprogram dengan Admin API, menggunakan kunci Admin API atau token OAuth org:admin.

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

Admin API menerima dua kredensial:

Kunci Admin API (dimulai dengan sk-ant-admin...) yang dikirim di header x-api-key. Hanya anggota organisasi dengan peran admin yang dapat membuatnya. Lihat Membuat kunci Admin API.
Token bearer OAuth dengan cakupan org:admin yang dikirim di header authorization: Bearer. Hanya anggota dengan peran admin, owner, atau primary owner yang dapat memperolehnya. Lihat Memperoleh token bearer OAuth.

Autentikasi

Token bearer OAuth

CLI

ant auth login --profile admin --scope "org:admin"
export ANTHROPIC_OAUTH_TOKEN=$(ant auth print-credentials --profile admin --access-token)

Token interaktif berumur pendek; jika permintaan mulai mengembalikan 401, jalankan kembali perintah export, yang akan menyegarkan token secara otomatis.

Panggil Admin API dengan token yang telah diekspor:

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 yang mendasarinya atau aturan federasi terikat.

Untuk CI dan beban kerja non-interaktif lainnya, buat token dengan Workload Identity Federation alih-alih masuk secara interaktif. Lihat Mengelola WIF dengan Admin API.

Kunci Admin API

Untuk membuat kunci Admin API untuk jenis organisasi Anda, lihat Membuat 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 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

# Mencantumkan 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. Setiap kunci dalam respons menyertakan timestamp expires_at-nya (null untuk kunci tanpa kedaluwarsa):

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 beban kerja 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, audit expires_at setiap kunci, dan rotasi kunci secara berkala

FAQ

Untuk pertanyaan khusus workspace, lihat FAQ Workspace.

Was this page helpful?

Autentikasi

Token bearer OAuth

Kunci Admin API

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

Token bearer OAuth

Kunci Admin API

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

Token bearer OAuth

Kunci Admin API

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

Token bearer OAuth

Kunci Admin API

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