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 akzeptiert zwei Anmeldedaten: einen Admin-API-Key (beginnend mit sk-ant-admin...), der im x-api-key-Header gesendet wird, oder ein OAuth-Bearer-Token mit dem org:admin-Scope, das im authorization: Bearer-Header gesendet wird. Nur Organisationsmitglieder mit der Admin-Rolle können Admin-API-Keys bereitstellen, und nur Mitglieder mit der Rolle Admin, Owner oder Primary Owner können org:admin-Tokens erhalten. Siehe Einen Admin-API-Key erstellen.

Claude Platform auf AWS: Der Großteil der Admin API ist auf der Claude Platform auf AWS nicht verfügbar. Workspace-Endpunkte (create, get, list, update und archive auf /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.

Authentifizierung

Authentifiziere dich mit einem der beiden Anmeldedaten. Um einen Admin-API-Key für deinen Organisationstyp zu erstellen, siehe Einen Admin-API-Key erstellen. Die folgenden Beispiele rufen den Endpunkt für Organisationsinformationen auf beide Arten auf:

OAuth-Bearer:

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"

Ein org:admin-Token gewährt Zugriff auf die gesamte Organisation, unabhängig davon, an welchen Workspace das zugrunde liegende Profil oder die Föderationsregel gebunden ist. Um eines zu erhalten, siehe die Voraussetzungen in WIF mit der Admin API verwalten.

Admin-API-Key:

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"

Wie die Admin API funktioniert

Wenn du die Admin API verwendest:

Du stellst Anfragen mit einem der beiden Anmeldedaten aus dem Abschnitt Authentifizierung
Die API ermöglicht es dir, Folgendes zu verwalten:
- Organisationsmitglieder und ihre Rollen
- Einladungen für Organisationsmitglieder
- Workspaces und ihre Mitglieder
- API-Keys
- Service-Accounts, Föderations-Issuer und Föderationsregeln (diese Endpunkte erfordern ein org:admin-OAuth-Token; Admin-API-Keys werden nicht akzeptiert)

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 roles and permissions.

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 Vorstehende tun und zusätzlich Benutzer verwalten

Organisations-Owner und Primary Owner haben alle Admin-Berechtigungen und können zusätzlich Admins verwalten. Alle Verweise auf die Admin-Rolle auf dieser Seite gelten auch für Owner und Primary Owner.

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

# Mitgliederrolle 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 in 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 dem 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"
  }'

Service-Accounts

Erstelle und verwalte Service-Accounts (svac_...), die nicht-menschlichen Identitäten, als die Workload Identity Federation-Tokens agieren. Admin-API-Keys werden auf den Endpunkten für Service-Accounts, Föderations-Issuer oder Föderationsregeln nicht akzeptiert; verwende ein org:admin-OAuth-Token. Siehe WIF mit der Admin API verwalten.

Föderations-Issuer

Registriere die OIDC-Identitätsanbieter (fdis_...), deren Tokens Workload-Identität für deine Organisation geltend machen dürfen. Siehe WIF mit der Admin API verwalten.

Föderationsregeln

Verwalte die Regeln (fdrl_...), die Issuer-Tokens auf Service-Accounts und Scopes abbilden. Siehe WIF mit der Admin API verwalten.

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 bestimmen, zu welcher Organisation ein Admin-API-Key gehört.

Vollständige Parameterdetails und Antwortschemata findest du in der API-Referenz für Organisationsinformationen.

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 Die Compliance API einrichten.

Best Practices

Um die Admin API effektiv zu nutzen:

Verwende aussagekräftige Namen und Beschreibungen für Workspaces und API-Keys
Implementiere eine ordnungsgemäße 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

Authentifizierung

OAuth-Bearer:

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"

Admin-API-Key:

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"

Wie die Admin API funktioniert

Wenn du die Admin API verwendest:

Du stellst Anfragen mit einem der beiden Anmeldedaten aus dem Abschnitt Authentifizierung
Die API ermöglicht es dir, Folgendes zu verwalten:
- Organisationsmitglieder und ihre Rollen
- Einladungen für Organisationsmitglieder
- Workspaces und ihre Mitglieder
- API-Keys
- Service-Accounts, Föderations-Issuer und Föderationsregeln (diese Endpunkte erfordern ein org:admin-OAuth-Token; Admin-API-Keys werden nicht akzeptiert)

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 roles and permissions.

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 Vorstehende tun und zusätzlich Benutzer verwalten

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

# Mitgliederrolle 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 in 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 dem 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"
  }'

Service-Accounts

Föderations-Issuer

Registriere die OIDC-Identitätsanbieter (fdis_...), deren Tokens Workload-Identität für deine Organisation geltend machen dürfen. Siehe WIF mit der Admin API verwalten.

Föderationsregeln

Verwalte die Regeln (fdrl_...), die Issuer-Tokens auf Service-Accounts und Scopes abbilden. Siehe WIF mit der Admin API verwalten.

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 bestimmen, zu welcher Organisation ein Admin-API-Key gehört.

Vollständige Parameterdetails und Antwortschemata findest du in der API-Referenz für Organisationsinformationen.

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 ordnungsgemäße 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?

Authentifizierung

Wie die Admin API funktioniert

Organisationsrollen und Berechtigungen

Wichtige Konzepte

Organisationsmitglieder

Organisationseinladungen

Workspaces

Workspace-Mitglieder

API-Keys

Service-Accounts

Föderations-Issuer

Föderationsregeln

Zugriff auf Organisationsinformationen

Nutzungs- und Kostenberichte

Claude Code-Analysen

Ratenlimits

Compliance API

Best Practices

FAQ

Welche Berechtigungen werden benötigt, 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 Organisations-Admins über die API entfernt werden?

Wie lange sind Organisationseinladungen gültig?

Authentifizierung

Wie die Admin API funktioniert

Organisationsrollen und Berechtigungen

Wichtige Konzepte

Organisationsmitglieder

Organisationseinladungen

Workspaces

Workspace-Mitglieder

API-Keys

Service-Accounts

Föderations-Issuer

Föderationsregeln

Zugriff auf Organisationsinformationen

Nutzungs- und Kostenberichte

Claude Code-Analysen

Ratenlimits

Compliance API

Best Practices

FAQ

Welche Berechtigungen werden benötigt, 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 Organisations-Admins über die API entfernt werden?

Wie lange sind Organisationseinladungen gültig?

Authentifizierung

Wie die Admin API funktioniert

Organisationsrollen und Berechtigungen

Wichtige Konzepte

Organisationsmitglieder

Organisationseinladungen

Workspaces

Workspace-Mitglieder

API-Keys

Service-Accounts

Föderations-Issuer

Föderationsregeln

Zugriff auf Organisationsinformationen

Nutzungs- und Kostenberichte

Claude Code-Analysen

Ratenlimits

Compliance API

Best Practices

FAQ

Authentifizierung

Wie die Admin API funktioniert

Organisationsrollen und Berechtigungen

Wichtige Konzepte

Organisationsmitglieder

Organisationseinladungen

Workspaces

Workspace-Mitglieder

API-Keys

Service-Accounts

Föderations-Issuer

Föderationsregeln

Zugriff auf Organisationsinformationen

Nutzungs- und Kostenberichte

Claude Code-Analysen

Ratenlimits

Compliance API

Best Practices

FAQ