The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
Die Admin API ermöglicht es Ihnen, die Ressourcen Ihrer Organisation programmatisch zu verwalten, einschließlich Organisationsmitgliedern, Arbeitsbereichen und API-Schlüsseln. Dies bietet programmatische Kontrolle über administrative Aufgaben, die andernfalls eine manuelle Konfiguration in der Anthropic Console erfordern würden.
Die Admin API erfordert besonderen Zugang
Die Admin API erfordert einen speziellen Admin API-Schlüssel (beginnend mit sk-ant-admin...), der sich von Standard-API-Schlüsseln unterscheidet. Nur Organisationsmitglieder mit der Admin-Rolle können Admin API-Schlüssel über die Anthropic Console bereitstellen.
Verwalten Sie den Benutzerzugang zu spezifischen Arbeitsbereichen:
# Mitglied zu Arbeitsbereich hinzufügencurl--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"}'# Arbeitsbereich-Mitglieder auflistencurl"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"# Mitgliederrolle aktualisierencurl--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"}'# Mitglied aus Arbeitsbereich entfernencurl--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"
Nur Organisationsmitglieder mit der Admin-Rolle können die Admin API verwenden. Sie müssen auch einen speziellen Admin API-Schlüssel haben (beginnend mit sk-ant-admin).
Nein, neue API-Schlüssel können aus Sicherheitsgründen nur über die Anthropic Console erstellt werden. Die Admin API kann nur bestehende API-Schlüssel verwalten.
API-Schlüssel bleiben in ihrem aktuellen Zustand bestehen, da sie auf die Organisation und nicht auf einzelne Benutzer beschränkt sind.
Nein, Organisationsmitglieder mit der Admin-Rolle können aus Sicherheitsgründen nicht über die API entfernt werden.
Organisationseinladungen laufen nach 21 Tagen ab. Es gibt derzeit keine Möglichkeit, diese Ablaufzeit zu ändern.
Ja, Sie können maximal 100 Arbeitsbereiche pro Organisation haben. Archivierte Arbeitsbereiche zählen nicht zu diesem Limit.
Jede Organisation hat einen “Standard-Arbeitsbereich”, der nicht bearbeitet oder entfernt werden kann und keine ID hat. Dieser Arbeitsbereich erscheint nicht in den Arbeitsbereich-Listen-Endpunkten.
Organisationsadministratoren erhalten automatisch die workspace_admin Rolle für alle Arbeitsbereiche. Organisationsabrechnungsmitglieder erhalten automatisch die workspace_billing Rolle. Organisationsbenutzer und -entwickler müssen manuell zu jedem Arbeitsbereich hinzugefügt werden.
Organisationsbenutzer und -entwickler können die Rollen workspace_admin, workspace_developer oder workspace_user zugewiesen bekommen. Die workspace_billing Rolle kann nicht manuell zugewiesen werden - sie wird von der Organisations-billing Rolle vererbt.
Nur Organisationsabrechnungsmitglieder können ihre Arbeitsbereich-Rolle auf eine Admin-Rolle hochgestuft bekommen. Ansonsten können Organisationsadministratoren und Abrechnungsmitglieder ihre Arbeitsbereich-Rollen nicht ändern lassen oder aus Arbeitsbereichen entfernt werden, solange sie diese Organisationsrollen innehaben. Ihr Arbeitsbereich-Zugang muss durch eine vorherige Änderung ihrer Organisationsrolle modifiziert werden.
Wenn ein Organisationsadministrator oder Abrechnungsmitglied zu Benutzer oder Entwickler herabgestuft wird, verliert er den Zugang zu allen Arbeitsbereichen außer denen, wo ihm manuell Rollen zugewiesen wurden. Wenn Benutzer zu Admin- oder Abrechnungsrollen befördert werden, erhalten sie automatischen Zugang zu allen Arbeitsbereichen.