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-tugas administratif yang sebaliknya memerlukan konfigurasi manual di Anthropic 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 Anthropic Console.
Buat dan kelola workspace (console) untuk mengorganisir sumber daya Anda:
# Buat workspacecurl--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 workspacecurl"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 workspacecurl--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"
# Tambahkan anggota ke workspacecurl--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 workspacecurl"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 anggotacurl--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 workspacecurl--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"
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 Anthropic 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 batasan ini.
Setiap Organisasi memiliki “Default Workspace” yang tidak dapat diedit atau dihapus, dan tidak memiliki ID. Workspace ini tidak muncul di endpoint daftar workspace.
Admin organisasi secara otomatis mendapat peran workspace_admin ke semua workspace. Anggota billing organisasi secara otomatis mendapat peran workspace_billing. Pengguna dan developer organisasi harus ditambahkan secara manual ke setiap workspace.
Pengguna dan developer 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 billing organisasi yang dapat memiliki peran workspace mereka ditingkatkan ke peran admin. Selain itu, admin dan anggota billing organisasi 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 atau anggota billing organisasi diturunkan ke pengguna atau developer, mereka kehilangan akses ke semua workspace kecuali yang mereka ditetapkan peran secara manual. Ketika pengguna dipromosikan ke peran admin atau billing, mereka mendapat akses otomatis ke semua workspace.