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 programmgesteuert zu verwalten, einschließlich Organisationsmitglieder, Workspaces und API-Schlüssel. Dies bietet programmgesteuerte Kontrolle über administrative Aufgaben, die sonst eine manuelle Konfiguration in der Anthropic Console erfordern würden.

Die Admin-API erfordert speziellen Zugriff

Die Admin-API benötigt 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.

​
Wie die Admin-API funktioniert

Wenn Sie die Admin-API verwenden:

  1. Sie stellen Anfragen mit Ihrem Admin-API-Schlüssel im x-api-key Header
  2. Die API ermöglicht es Ihnen, Folgendes zu verwalten:
    • Organisationsmitglieder und ihre Rollen
    • Einladungen für Organisationsmitglieder
    • Workspaces und deren Mitglieder
    • API-Schlüssel

Dies ist nützlich für:

  • Automatisierung des Onboarding/Offboarding von Benutzern
  • Programmgesteuerte Verwaltung des Workspace-Zugriffs
  • Überwachung und Verwaltung der API-Schlüsselnutzung

​
Organisationsrollen und Berechtigungen

Es gibt fünf Rollen auf Organisationsebene.

RolleBerechtigungen
userKann Workbench nutzen
claude_code_userKann Workbench und Claude Code nutzen
developerKann Workbench nutzen und API-Schlüssel verwalten
billingKann Workbench nutzen und Abrechnungsdetails verwalten
adminKann all das oben Genannte tun, plus Benutzer verwalten

​
Schlüsselkonzepte

​
Organisationsmitglieder

Sie können Organisationsmitglieder auflisten, Mitgliederrollen aktualisieren und Mitglieder entfernen.

# Organisationsmitglieder auflisten
curl "https://api.anthropic.com/v1/organizations/users?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Mitgliederrolle aktualisieren
curl "https://api.anthropic.com/v1/organizations/users/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"role": "developer"}'

# Mitglied entfernen
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"

​
Organisationseinladungen

Sie können Benutzer zu Organisationen einladen und diese Einladungen verwalten.

# Einladung erstellen
curl --request POST "https://api.anthropic.com/v1/organizations/invites" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "email": "newuser@domain.com",
    "role": "developer"
  }'

# Einladungen auflisten
curl "https://api.anthropic.com/v1/organizations/invites?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Einladung löschen
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"

​
Workspaces

Erstellen und verwalten Sie Workspaces, um Ihre Ressourcen zu organisieren:

# Workspace erstellen
curl --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"}'

# Workspaces auflisten
curl "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"

# Workspace archivieren
curl --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"

​
Workspace-Mitglieder

Verwalten Sie den Benutzerzugriff auf bestimmte Workspaces:

# Mitglied zum Workspace hinzufügen
curl --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"
  }'

# Workspace-Mitglieder auflisten
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"

# Mitgliederrolle aktualisieren
curl --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 Workspace entfernen
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"

​
API-Schlüssel

Überwachen und verwalten Sie API-Schlüssel:

# API-Schlüssel auflisten
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"

# API-Schlüssel aktualisieren
curl --request POST "https://api.anthropic.com/v1/organizations/api_keys/{api_key_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "status": "inactive",
    "name": "New Key Name"
  }'

​
Best Practices

Um die Admin-API effektiv zu nutzen:

  • Verwenden Sie aussagekräftige Namen und Beschreibungen für Workspaces und API-Schlüssel
  • Implementieren Sie eine ordnungsgemäße Fehlerbehandlung für fehlgeschlagene Operationen
  • Überprüfen Sie regelmäßig Mitgliederrollen und Berechtigungen
  • Bereinigen Sie ungenutzte Workspaces und abgelaufene Einladungen
  • Überwachen Sie die API-Schlüsselnutzung und wechseln Sie Schlüssel regelmäßig

​
FAQ