AdminOrganisation

Admin API

Die Admin API ist für Einzelkonten nicht verfügbar. Um mit Teammitgliedern zusammenzuarbeiten und Mitglieder hinzuzufügen, richte deine Organisation unter Console → Settings → Organization ein.

Die Admin API ermöglicht es dir, die Ressourcen deiner Organisation programmatisch zu verwalten, einschließlich Organisationsmitgliedern, Workspaces und API-Keys. Dies bietet programmatische Kontrolle über administrative Aufgaben, die andernfalls eine manuelle Konfiguration in der Claude Console erfordern würden.

Die Admin API erfordert speziellen Zugriff

Die Admin API erfordert einen speziellen Admin-API-Key (beginnend mit sk-ant-admin...), der sich von Standard-API-Keys unterscheidet. Nur Organisationsmitglieder mit der Admin-Rolle können Admin-API-Keys über die Claude Console bereitstellen.

Claude Platform auf AWS: Der Großteil der Admin API ist auf Claude Platform auf AWS nicht verfügbar. Workspace-Endpunkte (Erstellen, Abrufen, Auflisten, Aktualisieren und Archivieren unter /v1/organizations/workspaces) sind verfügbar. Andere Endpunkte, einschließlich Organisationsmitglieder, Workspace-Mitglieder, Einladungen, API-Keys, Nutzungsberichte, Kostenberichte und Ratenlimit-Berichte, sind nicht verfügbar. Siehe Claude Platform auf AWS für Details.

Wie die Admin API funktioniert

Wenn du die Admin API verwendest:

Du stellst Anfragen mit deinem Admin-API-Key im x-api-key-Header
Die API ermöglicht dir die Verwaltung von:
- Organisationsmitgliedern und ihren Rollen
- Einladungen für Organisationsmitglieder
- Workspaces und ihren Mitgliedern
- API-Keys

Dies ist nützlich für:

Automatisierung des Onboardings/Offboardings von Benutzern
Programmatische Verwaltung des Workspace-Zugriffs
Überwachung und Verwaltung der API-Key-Nutzung

Organisationsrollen und Berechtigungen

Es gibt fünf Rollen auf Organisationsebene. Weitere Details findest du im Artikel API Console-Rollen und -Berechtigungen.

Rolle	Berechtigungen
user	Kann Workbench verwenden
claude_code_user	Kann Workbench und Claude Code verwenden
developer	Kann Workbench verwenden und API-Keys verwalten
billing	Kann Workbench verwenden und Abrechnungsdetails verwalten
admin	Kann alles oben Genannte tun und zusätzlich Benutzer verwalten

Zentrale Konzepte

Organisationsmitglieder

Du kannst Organisationsmitglieder auflisten, Mitgliederrollen aktualisieren und Mitglieder entfernen.

cURL

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

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

# 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

Du kannst Benutzer zu Organisationen einladen und diese Einladungen verwalten.

cURL

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

# 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

Einen umfassenden Leitfaden zu Workspaces, einschließlich Console- und API-Beispielen, findest du unter Workspaces.

Workspace-Mitglieder

Verwalte den Benutzerzugriff auf bestimmte Workspaces:

cURL

# 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 "content-type: application/json" \
  --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"

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

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

Überwache und verwalte API-Keys:

cURL

# API-Keys 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-Key aktualisieren
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"
  }'

Zugriff auf Organisationsinformationen

Rufe Informationen über deine Organisation programmatisch mit dem Endpunkt /v1/organizations/me ab.

Zum Beispiel:

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

Dieser Endpunkt ist nützlich, um programmatisch zu ermitteln, zu welcher Organisation ein Admin-API-Key gehört.

Vollständige Parameterdetails und Antwortschemata findest du in der Organization Info API-Referenz.

Nutzungs- und Kostenberichte

Verfolge die Nutzung und Kosten deiner Organisation mit der Usage and Cost API.

Claude Code-Analysen

Überwache die Entwicklerproduktivität und die Einführung von Claude Code mit der Claude Code Analytics API.

Ratenlimits

Lies die für deine Organisation und ihre Workspaces konfigurierten Ratenlimits mit der Rate Limits API aus.

Compliance API

Rufe Audit- und Aktivitätsdaten für deine Organisation mit der Compliance API ab. Admin-API-Keys können nur den Activity Feed lesen; für vollständigen Zugriff siehe Zugriff auf die Compliance API erhalten.

Best Practices

Um die Admin API effektiv zu nutzen:

Verwende aussagekräftige Namen und Beschreibungen für Workspaces und API-Keys
Implementiere eine angemessene Fehlerbehandlung für fehlgeschlagene Operationen
Überprüfe regelmäßig Mitgliederrollen und Berechtigungen
Bereinige ungenutzte Workspaces und abgelaufene Einladungen
Überwache die API-Key-Nutzung und rotiere Keys regelmäßig

FAQ

Für Workspace-spezifische Fragen siehe die Workspaces-FAQ.

Was this page helpful?

AdminOrganisation

Admin API

Die Admin API erfordert speziellen Zugriff

Wie die Admin API funktioniert

Wenn du die Admin API verwendest:

Du stellst Anfragen mit deinem Admin-API-Key im x-api-key-Header
Die API ermöglicht dir die Verwaltung von:
- Organisationsmitgliedern und ihren Rollen
- Einladungen für Organisationsmitglieder
- Workspaces und ihren Mitgliedern
- API-Keys

Dies ist nützlich für:

Automatisierung des Onboardings/Offboardings von Benutzern
Programmatische Verwaltung des Workspace-Zugriffs
Überwachung und Verwaltung der API-Key-Nutzung

Organisationsrollen und Berechtigungen

Es gibt fünf Rollen auf Organisationsebene. Weitere Details findest du im Artikel API Console-Rollen und -Berechtigungen.

Rolle	Berechtigungen
user	Kann Workbench verwenden
claude_code_user	Kann Workbench und Claude Code verwenden
developer	Kann Workbench verwenden und API-Keys verwalten
billing	Kann Workbench verwenden und Abrechnungsdetails verwalten
admin	Kann alles oben Genannte tun und zusätzlich Benutzer verwalten

Zentrale Konzepte

Organisationsmitglieder

Du kannst Organisationsmitglieder auflisten, Mitgliederrollen aktualisieren und Mitglieder entfernen.

cURL

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

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

# 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

Du kannst Benutzer zu Organisationen einladen und diese Einladungen verwalten.

cURL

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

# 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

Einen umfassenden Leitfaden zu Workspaces, einschließlich Console- und API-Beispielen, findest du unter Workspaces.

Workspace-Mitglieder

Verwalte den Benutzerzugriff auf bestimmte Workspaces:

cURL

# 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 "content-type: application/json" \
  --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"

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

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

Überwache und verwalte API-Keys:

cURL

# API-Keys 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-Key aktualisieren
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"
  }'

Zugriff auf Organisationsinformationen

Rufe Informationen über deine Organisation programmatisch mit dem Endpunkt /v1/organizations/me ab.

Zum Beispiel:

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

Dieser Endpunkt ist nützlich, um programmatisch zu ermitteln, zu welcher Organisation ein Admin-API-Key gehört.

Vollständige Parameterdetails und Antwortschemata findest du in der Organization Info API-Referenz.

Nutzungs- und Kostenberichte

Verfolge die Nutzung und Kosten deiner Organisation mit der Usage and Cost API.

Claude Code-Analysen

Überwache die Entwicklerproduktivität und die Einführung von Claude Code mit der Claude Code Analytics API.

Ratenlimits

Lies die für deine Organisation und ihre Workspaces konfigurierten Ratenlimits mit der Rate Limits API aus.

Compliance API

Best Practices

Um die Admin API effektiv zu nutzen:

Verwende aussagekräftige Namen und Beschreibungen für Workspaces und API-Keys
Implementiere eine angemessene Fehlerbehandlung für fehlgeschlagene Operationen
Überprüfe regelmäßig Mitgliederrollen und Berechtigungen
Bereinige ungenutzte Workspaces und abgelaufene Einladungen
Überwache die API-Key-Nutzung und rotiere Keys regelmäßig

FAQ

Für Workspace-spezifische Fragen siehe die Workspaces-FAQ.

Was this page helpful?

Wie die Admin API funktioniert

Organisationsrollen und Berechtigungen

Zentrale Konzepte

Organisationsmitglieder

Organisationseinladungen

Workspaces

Workspace-Mitglieder

API-Keys

Zugriff auf Organisationsinformationen

Nutzungs- und Kostenberichte

Claude Code-Analysen

Ratenlimits

Compliance API

Best Practices

FAQ

Welche Berechtigungen sind erforderlich, um die Admin API zu verwenden?

Kann ich neue API-Keys über die Admin API erstellen?

Was passiert mit API-Keys, wenn ein Benutzer entfernt wird?

Können Organisationsadministratoren über die API entfernt werden?

Wie lange sind Organisationseinladungen gültig?

Wie die Admin API funktioniert

Organisationsrollen und Berechtigungen

Zentrale Konzepte

Organisationsmitglieder

Organisationseinladungen

Workspaces

Workspace-Mitglieder

API-Keys

Zugriff auf Organisationsinformationen

Nutzungs- und Kostenberichte

Claude Code-Analysen

Ratenlimits

Compliance API

Best Practices

FAQ

Welche Berechtigungen sind erforderlich, um die Admin API zu verwenden?

Kann ich neue API-Keys über die Admin API erstellen?

Was passiert mit API-Keys, wenn ein Benutzer entfernt wird?

Können Organisationsadministratoren über die API entfernt werden?

Wie lange sind Organisationseinladungen gültig?