Plugins-API
Erfasse und verwalte die Plugins in deiner Claude Enterprise-Organisation: Lade Plugins und Versionen hoch, wähle die Version, die Mitgliedern bereitgestellt wird, lege fest, wer welches Plugin nutzen kann, lade Plugin-Dateien zur Prüfung herunter und validiere einen Marketplace, bevor du ihn verbindest.
Mit der Plugins API kannst du Folgendes tun:
- Die Plugins in deiner Claude Enterprise-Organisation inventarisieren
- Plugins und neue Versionen aus deinen eigenen Pipelines veröffentlichen
- Auswählen, welche Version Mitgliedern bereitgestellt wird
- Steuern, wer jedes Plugin verwenden kann
- Plugin-Dateien zur Prüfung herunterladen
- Einen Git-Marketplace prüfen, bevor du ihn verbindest
Berichte zur Nutzung von Plugins (welche Plugins und Skills Mitglieder nutzen und wie oft) findest du unter Analytics-APIs.
Endpunkte
Die API stellt 18 Endpunkte für fünf Ressourcen bereit:
| Ressource | Endpunkte |
|---|---|
| Plugins: die Plugins der Organisation auflisten, ein neues hochladen, eines abrufen, die Version wählen, die Mitgliedern bereitgestellt wird (Rollback oder Promotion), eines löschen | GET /v1/organizations/pluginsPOST /v1/organizations/pluginsGET /v1/organizations/plugins/{plugin_id}POST /v1/organizations/plugins/{plugin_id}DELETE /v1/organizations/plugins/{plugin_id} |
| Plugin-Versionen: den Versionsverlauf eines Plugins auflisten, eine neue Version hochladen, eine abrufen, die Dateien einer Version herunterladen | GET /v1/organizations/plugins/{plugin_id}/versionsPOST /v1/organizations/plugins/{plugin_id}/versionsGET /v1/organizations/plugins/{plugin_id}/versions/{version}GET /v1/organizations/plugins/{plugin_id}/versions/{version}/content |
| Installationseinstellungen: lesen, wer ein organisationseigenes Plugin nutzen kann, dies für die gesamte Organisation oder für eine Gruppe festlegen, eine der beiden Einstellungen entfernen | GET /v1/organizations/plugins/{plugin_id}/installation_settingsPOST /v1/organizations/plugins/{plugin_id}/installation_settings/{target}DELETE /v1/organizations/plugins/{plugin_id}/installation_settings/{target} |
| Freigaben: lesen, mit wem ein Mitglied sein eigenes Plugin geteilt hat (nur lesend) | GET /v1/organizations/plugins/{plugin_id}/shares |
| Plugin-Marketplaces: die ID eines Marketplace finden, einen abrufen, die Standard-Installationseinstellung für seine Plugins festlegen, Marketplace-Inhalte vor dem Verbinden prüfen | GET /v1/organizations/plugin_marketplacesGET /v1/organizations/plugin_marketplaces/{marketplace_id}POST /v1/organizations/plugin_marketplaces/{marketplace_id}POST /v1/organizations/plugin_marketplaces/validate_repositoryPOST /v1/organizations/plugin_marketplaces/validate_archive |
Plugins, die Anthropic veröffentlicht, werden nicht erfasst; ihre Nutzung wird von den Analytics-APIs gemeldet. Marketplaces werden in claude.ai erstellt, mit Repositories verbunden und gelöscht, nicht über diese API.
Voraussetzungen
- Deine Organisation muss einen Claude Enterprise-Plan haben.
- Dein Haupteigentümer erstellt einen Admin-API-Key mit dem Scope
read:plugins, dem Scopewrite:pluginsoder beiden unter claude.ai > Organisationseinstellungen > API. Siehe Key für eine Claude Enterprise-Organisation erstellen. - Jede Anfrage enthält drei Header:
x-api-key,anthropic-version: 2026-10-21undanthropic-beta: ce-plugins-2026-09-01.
In Python, TypeScript, C#, Go, Java, PHP und Ruby stellt das SDK diese Endpunkte unter client.beta.organization bereit und die ant CLI unter ant beta:organization; sie senden die Header anthropic-version und anthropic-beta für dich. Die Beispiele auf dieser Seite lesen den Admin-API-Key aus der Umgebungsvariable ANTHROPIC_API_KEY. Wo ein SDK oder die CLI weitere Seiten für dich abruft, legt limit die Seitengröße fest, nicht die Gesamtzahl (siehe Paginierung).
API-Keys gehören der Organisation und funktionieren weiter, nachdem die Person, die sie erstellt hat, die Organisation verlässt. Teile sie nicht und checke sie nicht in die Versionskontrolle ein.
Schnellstart
Liste die Plugins in den eigenen Marketplaces deiner Organisation auf, die neuesten zuerst:
client = anthropic.Anthropic()
plugins = client.beta.organization.plugins.list(owner_type="organization", limit=20)
# Ruft bei Bedarf automatisch weitere Seiten ab.
for plugin in plugins:
print(f"{plugin.id}: {plugin.name}"){
"data": [
{
"type": "plugin",
"id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
"name": "sales-toolkit",
"display_name": "Sales Toolkit",
"description": "Account research and call prep for the sales team.",
"served_version_id": "pluginver_01Km7tL4pR9xF5sU2zV3jP6q",
"served_version_pinned": true,
"latest_version_id": "pluginver_01Jd5sK2nQ8wE4rT6yU1iO3p",
"manifest_version": "1.4.0",
"owner": { "type": "organization" },
"marketplace_id": "marketplace_01Lp8uM5qS1yG6tV3aW4kQ7r",
"created_by": { "type": "api_actor", "api_key_id": "apikey_01Nq9vN6rT2zH7uW4bX5mR8s" },
"organization_installation_preference": "available",
"organization_installation_preference_inherited": true,
"content_scan": { "status": "completed", "assessment": "pass", "reason": null },
"components": [
{
"type": "skill",
"name": "account-research",
"description": "Researches a customer account before a call."
},
{ "type": "mcp_server", "name": "crm", "description": null }
],
"reach": "remote",
"created_at": "2026-09-01T17:04:11Z",
"updated_at": "2026-09-15T14:12:30Z"
}
],
"next_page": "page_xK9f2LqT7vNw3pRzBd8sHy"
}In diesem Beispiel ist das Plugin auf eine frühere Version festgelegt: Eine neuere Version (latest_version_id) ist gespeichert, wird aber noch nicht bereitgestellt.
Scopes
| Scope | Gewährt |
|---|---|
read:plugins | Jeden GET-Endpunkt auf dieser Seite, einschließlich Archiv-Downloads, sowie die Marketplace-Validierung. |
write:plugins | Jeden POST- und DELETE-Endpunkt auf dieser Seite: ein Plugin erstellen, eine Version erstellen, die bereitgestellte Version ändern, ein Plugin löschen, Installationseinstellungen festlegen und entfernen und den Standard eines Marketplace festlegen, sowie die Marketplace-Validierung. Er gewährt keine Lesezugriffe. |
read:org_audit | Ein reiner Lese-Scope für Sicherheitsaudit-Integrationen: jeden GET-Endpunkt auf dieser Seite, einschließlich Archiv-Downloads, sowie die Lese-Endpunkte der Benutzerverwaltung und der Compliance-API. Er gewährt weder die Marketplace-Validierung noch Schreibzugriffe. |
read:compliance_org_data | Der Scope der Compliance-API für Organisationsmetadaten (Namen, Typen, Rollen und Gruppen) und effektive Einstellungen. Gewährt jeden GET-Endpunkt auf dieser Seite, genau wie read:org_audit, sodass ein Compliance Access Key Plugins ohne einen zweiten Key lesen kann. Er gewährt weder die Marketplace-Validierung noch Schreibzugriffe. |
Ein Key kann mehrere Scopes haben. Eine Integration, die ein Plugin hochlädt und es anschließend wieder liest, benötigt sowohl read:plugins als auch write:plugins. Überall dort, wo diese Seite angibt, dass ein Endpunkt den Scope read:plugins erfordert, funktioniert auch ein Key mit read:org_audit oder read:compliance_org_data.
Zugriff auf die Plugin-Dateien von Mitgliedern
Jeder dieser Lese-Scopes (read:plugins, read:org_audit und read:compliance_org_data) kann die Dateien von Plugins in den persönlichen Marketplaces von Mitgliedern herunterladen, einschließlich Dateien, die die Admin-Einstellungen von claude.ai nicht anzeigen, und ein an deine übergeordnete Organisation gebundener Key mit read:org_audit oder read:compliance_org_data kann dies in jeder darunterliegenden Organisation tun, die Zugriff auf diese API hat, indem er organization_id übergibt (siehe Eine andere Organisation unter derselben übergeordneten Organisation lesen). Jeder solche Download erzeugt ein claude_plugin_archive_accessed-Ereignis im Activity Feed der Compliance-API, das den Key, das Plugin, die Version und das Mitglied identifiziert (siehe Activity-Feed-Ereignisse). Downloads von Plugins der Organisation werden nicht erfasst.
Eine andere Organisation unter derselben übergeordneten Organisation lesen
read:plugins- und write:plugins-Keys lesen und schreiben nur in der Organisation, in der sie erstellt wurden. Manche Unternehmen haben mehrere Claude-Organisationen, die unter einer übergeordneten Organisation verknüpft sind. Ein für alle verknüpften Organisationen erstellter read:org_audit- oder read:compliance_org_data-Key kann auch jede verknüpfte Organisation lesen, die Zugriff auf diese API hat. Um eine davon zu lesen, übergib ihre ID im Query-Parameter organization_id bei einem beliebigen GET-Endpunkt auf dieser Seite. Die ID ist die Organisations-UUID, die in den Einstellungen von claude.ai angezeigt wird (ihre Form mit dem Präfix org_ wird ebenfalls akzeptiert). Ohne den Parameter liest der Key die Organisation, in der er erstellt wurde. Ein Key ohne eigene Organisation muss immer organization_id übergeben. Ein 404 bedeutet, dass die angegebene Organisation nicht unter der übergeordneten Organisation des Keys liegt oder die API für sie nicht verfügbar ist; ein Wert, der weder eine UUID noch eine org_-ID ist, gibt 400 zurück. Jeder andere Key, der eine andere Organisation als seine eigene angibt, erhält 404. Schreibvorgänge akzeptieren organization_id nicht.
Wichtige Konzepte
Plugins und Komponenten
Ein Plugin ist ein Paket, das Claude für die Mitglieder deiner Organisation erweitert. Es enthält eine beliebige Kombination dieser Komponenten:
| Komponente | Was sie ist |
|---|---|
| Skill | Anweisungen und Dateien, die Claude lädt, wenn eine Aufgabe sie erfordert. |
| Befehl | Ein gespeicherter Prompt, den ein Mitglied ausführt, indem es / gefolgt vom Namen des Commands eingibt. |
| Agent | Ein Hilfsassistent mit eigenen Anweisungen, an den Claude einen Teil einer Aufgabe übergeben kann. |
| Hook | Ein Befehl, der automatisch ausgeführt wird, wenn in einer Sitzung ein Ereignis eintritt, etwa bevor Claude ein Tool verwendet. |
| MCP-Server | Eine Verbindung von Claude zu Tools und Daten in einem anderen System (Model Context Protocol). |
| CLI | Ein Kommandozeilenprogramm, das Claude über das Plugin ausführen darf. |
Jedes Plugin hat ein Manifest unter .claude-plugin/plugin.json. Der name des Manifests wird zum name des Plugins: ein kleingeschriebener Bezeichner, der innerhalb seines Marketplace eindeutig ist.
Marketplaces
Ein Marketplace ist ein Container für Plugins. Jeder Marketplace hat einen Eigentümer und eine Quelle.
- Eigentümer. Die Organisation besitzt ihre Marketplaces. Jedes Mitglied kann außerdem persönliche Marketplaces haben.
- Quelle.
manualbedeutet, dass Plugins hochgeladen werden, in claude.ai oder, bei einem Marketplace der Organisation, über diese API.github,gitlabundpublic_gitbedeuten, dass Plugins aus einem Git-Repository synchronisiert werden, das der Eigentümer verbunden hat. In einen synchronisierten Marketplace kann nichts hochgeladen werden, und diese API kann seine Plugins nicht löschen, weil die nächste Synchronisierung jede dieser Änderungen rückgängig machen würde. Ändere stattdessen das Repository.
Der „library marketplace“ (Bibliotheks-Marketplace) deiner Organisation ist der manual-Marketplace der Organisation, in den Uploads gehen, wenn du keinen Marketplace angibst. Er wird erstellt, wenn zum ersten Mal etwas in ihn hochgeladen wird.
Plugins der Organisation und Plugins von Mitgliedern
Das Feld owner.type eines Plugins gibt an, in wessen Marketplace es sich befindet:
organization: Du kannst es über diese API verwalten, mit der Ausnahme, dass ein Plugin in einem aus Git synchronisierten Marketplace hier keine Uploads erhalten und nicht gelöscht werden kann.user: Es befindet sich im persönlichen Marketplace eines Mitglieds. Du kannst seine Details lesen und seine Dateien herunterladen und es löschen, wenn sein Marketplacemanualist. Das Hochladen von Versionen und das Wählen der bereitgestellten Version geben403zurück. Freigaben werden ausschließlich vom Mitglied in claude.ai verwaltet.
Das Entfernen eines Mitglieds aus der Organisation entfernt seine Plugins nicht. Sie bleiben unter der user_id des Mitglieds im Inventar, und der Filter owner_user_id findet sie weiterhin, sodass du die Inhalte eines ausgeschiedenen Mitglieds prüfen und entfernen kannst. Sie werden aus dem Inventar entfernt, wenn das Konto des Mitglieds gelöscht wird.
Versionen und die bereitgestellte Version
Jeder Upload erzeugt eine neue, unveränderliche Version, unabhängig davon, ob er über diese API, über claude.ai oder durch eine Git-Synchronisierung erfolgt. Ein Plugin hat zwei Zeiger auf seine Versionen:
latest_version_id: die neueste Versionserved_version_id: die Version, die Mitgliedern bereitgestellt wird
Standardmäßig ist served_version_pinned false: Die bereitgestellte Version folgt normalerweise der neuesten. Wenn das Content-Scanning aktiviert ist, kann eine in claude.ai gespeicherte Version auf ihren Content-Scan warten: Sie wird gespeichert, aber nicht sofort bereitgestellt. Diese Seite verwendet „warten“ nur für eine in claude.ai gespeicherte Version, nicht für eine, die ein Mitglied oder ein Administrator in ein Plugin veröffentlicht. Solange das Scanning aktiviert ist, wird eine wartende Version nur bereitgestellt, wenn ihr content_scan completed mit pass oder warn lautet. Während eine Version wartet, benennt served_version_id eine frühere Version als latest_version_id. Frage nicht so lange ab, bis die beiden IDs übereinstimmen: Sie könnten unterschiedlich bleiben, zum Beispiel wenn der Scan fehlschlägt.
Das Wählen einer Version mit POST /v1/organizations/plugins/{plugin_id} pinnt das Plugin (served_version_pinned: true). Dasselbe gilt, wenn ein Administrator in claude.ai eine Version wählt oder die Anfrage eines Mitglieds annimmt, in das Plugin zu veröffentlichen. Ab dann werden neue Uploads gespeichert und setzen latest_version_id weiter, aber Mitglieder behalten die gepinnte Version, bis du served_version_id auf eine andere Version setzt. Bei einem Plugin, dessen zwei Zeiger sich unterscheiden, gibt es eine gespeicherte Version, die nicht bereitgestellt wird.
So kann eine Release-Pipeline jeden Build hochladen, testen und dann hochstufen. Damit deine Pipeline bestimmt, wann jeder Build bereitgestellt wird, pinne das Plugin einmal, indem du served_version_id auf seine aktuelle Version setzt; stufe danach jeden Build hoch, der bereitgestellt werden soll. Bei aktiviertem Content-Scanning gibt dieses erste Pinnen 409 scan_pending zurück, solange der content_scan der aktuellen Version processing lautet, und 400 scan_failed, wenn der Scan fail, unknown oder errored lautet (warn wird akzeptiert). Ein gepinntes Plugin kann nicht entpinnt werden, weder hier noch in claude.ai.
Für ein Rollback setzt du served_version_id auf eine frühere Version. Ein Roll-forward funktioniert auf dieselbe Weise.
Diese Regeln beschreiben Plugins der Organisation. Die bereitgestellte Version eines Plugins eines Mitglieds wird von dessen Eigentümer in claude.ai gesteuert.
Installationseinstellungen
Installationseinstellungen bestimmen, wer ein Plugin der Organisation verwenden kann. Jede Einstellung hat einen von vier Werten, die in den Feldern mit dem Namen installation_preference (und, bei den Plugin- und Marketplace-Objekten, organization_installation_preference und default_installation_preference) übermittelt werden:
| Wert | Mitglieder sehen |
|---|---|
required | Das Plugin ist installiert und kann nicht entfernt werden. |
auto_install | Das Plugin ist installiert und kann entfernt werden. |
available | Das Plugin kann auf Wunsch installiert werden. |
not_available | Das Plugin ist ausgeblendet. |
Ein Plugin kann eine organisationsweite Einstellung und eine Einstellung für jede Gruppe haben (die Gruppen der rollenbasierten Zugriffskontrolle, verwaltet in der Benutzerverwaltung). Ein Mitglied erhält einen Wert nach diesen Regeln:
- Der organisationsweite Wert ist die eigene organisationsweite Einstellung des Plugins, falls vorhanden, andernfalls der Standard seines Marketplace, andernfalls
not_available. Das Plugin meldet diesen Wert inorganization_installation_preference, mitorganization_installation_preference_inherited: true, solange er aus dem Marketplace-Standard stammt. - Ein Mitglied, das keiner Gruppe mit einer Einstellung für das Plugin angehört, erhält den organisationsweiten Wert.
- Ein Mitglied, das einer oder mehreren Gruppen mit einer Einstellung angehört, erhält stattdessen die freizügigste Einstellung dieser Gruppen, in der Rangfolge
required,auto_install,available,not_available.
Die Einstellung einer Gruppe ersetzt den organisationsweiten Wert für ihre Mitglieder; sie ergänzt ihn nicht. Wenn der organisationsweite Wert zum Beispiel required ist und die Pilot-Gruppe available hat, erhalten Pilot-Mitglieder available. Wenn du ein Plugin von einer Pilotgruppe auf die gesamte Organisation ausweitest, lege den organisationsweiten Wert fest und entferne dann die Einstellung der Gruppe. Das Festlegen des organisationsweiten Werts beendet die Vererbung des Marketplace-Standards für das Plugin; das Entfernen der organisationsweiten Einstellung setzt das Plugin auf diesen Standard zurück.
Ein über diese API erstelltes Plugin hat anfangs keine eigenen Einstellungen und erbt daher den Standard seines Marketplace: not_available, sofern niemand einen Standard festgelegt hat. Das Löschen einer Gruppe entfernt ihre Einstellungen aus allen Plugins.
Freigaben
Freigaben bestimmen, wer ein Plugin eines Mitglieds verwenden kann. Der Owner gibt es in claude.ai für alle Mitglieder, für eine Gruppe oder für namentlich genannte Mitglieder frei. Diese API listet Freigaben auf, kann sie aber nicht ändern.
Wenn deine Organisation eine Art der Freigabe in ihren claude.ai-Einstellungen deaktiviert hat, erscheinen Freigaben dieser Art weiterhin in der Liste, gewähren aber niemandem Zugriff, solange diese Einstellung deaktiviert ist; die Liste selbst zeigt nicht an, ob das der Fall ist.
Content-Scanning
„Content scanning“ (Inhaltsprüfung) ist eine Organisationseinstellung in claude.ai. Wenn sie aktiviert ist, werden neu gespeicherte Versionen gescannt (claude.ai nimmt einige davon aus), und das Ergebnis wird in content_scan gemeldet; eine Version, die nicht gescannt wurde, zum Beispiel eine, die vor dem Aktivieren des Scannings gespeichert wurde, hat content_scan: null. Scanning wird Organisationen, die kundenverwaltete Verschlüsselungsschlüssel oder Zero Data Retention verwenden, nicht angeboten.
Solange das Scanning aktiviert ist, wird Mitgliedern ein Plugin nur bereitgestellt, wenn der Scan seiner bereitgestellten Version completed mit pass oder warn ist. Solange der Scan processing oder errored ist oder fail oder unknown lautet, wird das Plugin Mitgliedern vorenthalten, und an seiner Stelle wird keine frühere Version bereitgestellt. Eine Version, die nie gescannt wurde (content_scan: null), wird normal bereitgestellt.
Eine Version, die du über diese API hochlädst, wartet nie auf ihren Content-Scan. Wenn sie zur bereitgestellten Version wird, verlieren Mitglieder das Plugin, bis ihr content_scan completed mit pass oder warn lautet. Wenn Mitglieder die aktuelle Version behalten sollen, während eine neue gescannt wird, pinne das Plugin zuerst (siehe Versionen und die bereitgestellte Version).
Während eine in claude.ai gespeicherte Version auf ihren Scan wartet, ändert sich die bereitgestellte Version nicht. Wenn dein API-Upload zur bereitgestellten Version wird, endet jedes Warten: Die wartende Version wird nur bereitgestellt, wenn jemand sie auswählt. Um den Scan einer wartenden Version zu sehen, lies die Version (siehe Die Versionen eines Plugins auflisten).
Nach einem Upload ist content_scan.status processing, und das Urteil trifft asynchron ein. Lies die Version, um es zu sehen; das Plugin-Objekt zeigt nur den Scan seiner bereitgestellten Version. Während das Scanning aktiviert ist, gibt das Ändern der bereitgestellten Version auf eine Version, deren content_scan processing lautet, 409 scan_pending zurück, und das Ändern auf eine, deren Scan fail, unknown oder errored lautet, gibt 400 scan_failed zurück.
In claude.ai zugelassene fehlgeschlagene Scans
In claude.ai können Organisationseigentümer eine Version zulassen, deren Scan fehlgeschlagen ist. Dasselbe können Mitglieder, deren benutzerdefinierte Rolle Bibliotheken verwalten darf. Diese API kann diesen Scan dann als completed mit warn und dem reason des fehlgeschlagenen Scans melden. Solange sie das tut, gelten die Regeln für warn: Die Version kann Mitgliedern bereitgestellt werden, und du kannst sie zur bereitgestellten Version machen. Nichts in der Antwort zeigt, dass sie zugelassen wurde, daher ist ein warn entweder eine Warnung oder ein fehlgeschlagener Scan, der zugelassen wurde. Das Zulassen einer Version, deren Scan warn lautet, ändert ihren content_scan nicht. Wenn eine Version nicht mehr zugelassen ist, meldet diese API das Urteil ihres neuesten abgeschlossenen Scans. Eine bereitgestellte Version, deren Scan dann fail oder unknown lautet, wird Mitgliedern vorenthalten.
Reichweite
reach („reach“, Reichweite) fasst in einem Wert zusammen, wie weit eine Version auf den Rechnern der Mitglieder und darüber hinaus reicht:
| Wert | Bedeutung |
|---|---|
remote | Deklariert einen MCP-Server oder eine CLI, unabhängig davon, was sie sonst noch deklariert. |
privileged | Deklariert keinen MCP-Server und keine CLI, aber einen Hook, einen Monitor (einen Hintergrundbefehl, der während einer Sitzung weiterläuft), einen LSP-Server (Language Server Protocol), einen Workflow (ein Skript, das Claude Code ausführen kann; jede Datei in einem workflows/-Ordner im Stammverzeichnis des Plugins zählt als Workflow) oder Einstellungen, die das Plugin auf die App des Mitglieds anwendet, oder enthält einen Skill, einen Befehl oder eine andere Markdown-Datei, deren Frontmatter Tools vorab genehmigt (allowed-tools). Diese laufen oder wirken auf dem eigenen Computer des Mitglieds. |
contained | Deklariert keinen MCP-Server, keine CLI, keinen Hook, keinen Monitor, keinen LSP-Server, keinen Workflow und keine App-Einstellungen, und keine ihrer Markdown-Dateien genehmigt Tools vorab (zum Beispiel ein Plugin, das nur Skills, Befehle und Agenten enthält, keiner davon mit allowed-tools). |
reach berücksichtigt alles, was die Version deklariert, einschließlich Monitoren, LSP-Servern, Workflows und App-Einstellungen, die components nicht auflistet, sodass eine Version mit einer leeren components-Liste dennoch privileged sein kann. Der Wert ist null für eine Version, die gespeichert wurde, bevor Komponenten erfasst wurden, und für eine Version, deren Reichweite nicht bestimmt werden konnte, weil die SKILL.md eines ihrer Skills oder eine ihrer Command-Dateien nicht gelesen werden konnte; behandle null als nicht klassifiziert. Der Wert wird normalerweise beim Speichern einer Version nach den zu diesem Zeitpunkt geltenden Regeln ermittelt. Eine ältere Version kann daher contained sein, während dieselben Dateien, wenn sie heute gespeichert würden, privileged wären.
Anforderungen an Uploads
Uploads folgen denselben Regeln wie Plugin-Uploads in claude.ai, sodass an beiden Stellen dieselben Archive akzeptiert werden.
- Der Upload ist entweder ein einzelnes
.zip- oder.plugin-Archiv oder eine Menge einzelner Dateien. Ein Archiv darf alles in einen einzigen Ordner auf oberster Ebene einschließen. - Er muss genau ein Manifest unter
.claude-plugin/plugin.jsonenthalten, das einennamedeklarieren muss. Eine einzelneSKILL.mdohne Manifest wird abgelehnt. - Eine
SKILL.mdauf oberster Ebene, deren Frontmatter Plugin-Komponenten deklariert, wird mit dem Manifest zusammengeführt;plugin.jsonhat Vorrang, wo beide einen Wert festlegen. Einedescription, die das Manifest aus dieserSKILL.mdübernimmt, wird auf ihre ersten 500 Zeichen gekürzt. namedarf Kleinbuchstaben (aus jedem Alphabet), Ziffern und Bindestriche enthalten, bis zu 64 Zeichen. Großbuchstaben, Leerzeichen, Unterstriche und andere Satzzeichen werden abgelehnt.displayNamehat höchstens 64 Zeichen unddescriptionhöchstens 500.- Jede
SKILL.mdbenötigt gültiges YAML-Frontmatter mitnameunddescription, von denen keines XML-Tags wie<example>enthalten darf. Zwei Skills oder zwei Befehle dürfen nicht denselben Namen haben. - Keine Datei darf sich in einem
bin/-Verzeichnis auf oberster Ebene befinden. - Keine verschachtelten
.zip-Dateien. Paketierte MCP-Server (.mcpb,.dxt) sind erlaubt. - Dateipfade müssen relativ sein, dürfen kein
..enthalten und nur Buchstaben, Ziffern, Leerzeichen und_ . - / ( ) ,verwenden. - Der Request-Body und das unkomprimierte Archiv sind jeweils höchstens 200 MB groß; ein Request-Body über dem Limit gibt
413(request_too_large) statt400zurück. Ein Upload hat höchstens 5.000 Dateien, eine Pfadtiefe von 12, Pfade von 472 Zeichen und Datei- oder Ordnernamen von 255 Zeichen. - ZIP-Archive müssen DEFLATE- oder STORE-Komprimierung verwenden und dürfen weder verschlüsselt sein noch symbolische Links enthalten.
- Ein Upload, der ein Plugin erstellt, gibt
400zurück, sobald der Marketplace 1.000 Plugins enthält. Plugins, die diese API nicht auflistet, zählen ebenfalls mit, sodass das Limit erreicht werden kann, während Plugins auflisten in diesem Marketplace weniger als 1.000 anzeigt. Anthropic kann das Limit von 5.000 Dateien erhöhen.
Beispiel-Workflows
Jeden Build aus einer Release-Pipeline veröffentlichen
Lade jeden getaggten Build aus der CI hoch und lass die Pipeline bestimmen, wann ein Build bereitgestellt wird.
- Finde den Marketplace, in den hochgeladen werden soll, mit
GET /v1/organizations/plugin_marketplaces?owner_type=organization, oder lassmarketplace_idweg, um den Bibliotheks-Marketplace zu verwenden. - Beim ersten Release erstellst du das Plugin mit
POST /v1/organizations/plugins. Bei jedem späteren Release notierst du dielatest_version_iddes Plugins und lädst dann eine Version hoch mitPOST /v1/organizations/plugins/{plugin_id}/versions. Wenn die Antwort auf den Upload verloren geht, lies das Plugin und wiederhole den Upload nur, wennlatest_version_idunverändert ist (siehe Uploads wiederholen). - Damit Mitglieder die aktuelle Version behalten, während jeder neue Build geprüft wird, pinne das Plugin einmalig, indem du
served_version_idauf seine aktuelle Version setzt. Ab dann wird jeder Upload gespeichert, ohne bereitgestellt zu werden, und das Pinnen kann nicht rückgängig gemacht werden: Jeder Build, der bereitgestellt werden soll, benötigt Schritt 5. - Wenn Content-Scanning aktiviert ist, frage
GET /v1/organizations/plugins/{plugin_id}/versions/{version}ab, biscontent_scan.statusnicht mehrprocessingist, und promote nur, wenn der Statuscompletedmitpassoderwarnist. - Promote den Build mit
POST /v1/organizations/plugins/{plugin_id}und{"served_version_id": "<the new version's ID>"}. Für ein Rollback sendest du auf dieselbe Weise die ID der vorherigen Version.
Ein Plugin zuerst für eine Pilotgruppe und dann für alle ausrollen
-
Ermittle die ID der Pilotgruppe mit
GET /v1/organizations/rbac_groups. Dieser Aufruf benötigt den Scoperead:rbac_groups(siehe Gruppen und Rollen in der Benutzerverwaltung). Die nächsten Schritte benötigenwrite:plugins, das nur auf die Organisation wirkt, in der sein Key erstellt wurde. Erstelle daher in einem Unternehmen mit mehreren verknüpften Organisationen einen einzigen Key in der Organisation, die das Plugin enthält, und gib ihm beide Scopes, oder verwende für diese Schritte einen zweiten dort erstellten Key. -
Gib der Gruppe eine eigene Einstellung, zum Beispiel
auto_install, mitPOST /v1/organizations/plugins/{plugin_id}/installation_settings/{target}, wobei{target}dierbac_group_-ID der Gruppe ist, während der organisationsweite Wertnot_availablebleibt. Nur die Mitglieder der Gruppe erhalten das Plugin. -
Wenn der Pilot endet, lege den organisationsweiten Wert mit dem folgenden Aufruf fest und entferne dann die Einstellung der Gruppe, damit die Gruppe wieder der Organisation folgt. Das Festlegen des organisationsweiten Werts beendet die Vererbung des Marketplace-Standards für das Plugin; das Entfernen der organisationsweiten Einstellung setzt das Plugin später auf diesen Standard zurück.
Pythonclient = anthropic.Anthropic() setting = client.beta.organization.plugins.installation_settings.set( "organization", plugin_id="plugin_01Hq3vX8kZcN2mB7pR4tY9wL", installation_preference="required", ) print(f"plugin_id: {setting.plugin_id}") print(f"installation_preference: {setting.installation_preference}")Entferne dann die Einstellung der Gruppe mit
DELETE /v1/organizations/plugins/{plugin_id}/installation_settings/{target}, wobei{target}die ID der Gruppe ist. Die Einstellung einer Gruppe ersetzt den organisationsweiten Wert für ihre Mitglieder, statt ihn zu ergänzen, sodass eine verbliebene Gruppeneinstellungavailablediese Mitglieder aufavailablehalten würde.
Einen Sicherheitsbestand synchron halten
Führe einen nächtlichen Job aus, der Plugins markiert, die über die Sitzung des Mitglieds hinausreichen oder deren Content-Scan warn, fail oder unknown lautet.
- Blättere durch
GET /v1/organizations/plugins?limit=100, bisnext_pagenullist (siehe Paginierung). Lies bei jedem Laufreachundcontent_scanjedes Plugins aus dieser Liste: Eine Änderung allein ancontent_scan, etwa ein später eintreffendes Urteil, verändertupdated_atnicht.updated_atzeigt dir normalerweise, welche Plugins seit dem letzten Lauf neue Inhalte oder eine neue bereitgestellte Version haben (was einen erneuten Archiv-Download lohnt). Eine wartende Version (siehe Versionen und die bereitgestellte Version) verändertupdated_at, wenn sie zur bereitgestellten Version wird, nicht unbedingt, wenn sie gespeichert wird. Um eine solche zu bemerken, vergleichelatest_version_idmit dem Wert aus deinem letzten Lauf. Das vollständige erneute Auflisten erfasst auch Entfernungen, weil ein durch eine Git-Synchronisierung oder eine Kontolöschung entferntes Plugin ohne Ereignis verschwindet. - Markiere jedes Plugin, dessen
reachremoteist (es deklariert einen MCP-Server oder eine CLI) oder dessencontent_scan.assessmentwarn,failoderunknownist. Einwarnkann auch ein fehlgeschlagener Scan sein, der in claude.ai zugelassen wurde. Lasswarnnur weg, wenn du jeden dort zugelassenen fehlgeschlagenen Scan akzeptierst. Diese Felder beschreiben die bereitgestellte Version. Um auch eine neuere, nicht bereitgestellte Version zu prüfen, liste die Versionen des Plugins auf, wenn sichlatest_version_idvonserved_version_idunterscheidet (siehe Versionen eines Plugins auflisten). - Lade für jedes markierte Plugin das Archiv der bereitgestellten Version zur Prüfung mit
GET /v1/organizations/plugins/{plugin_id}/versions/{served_version_id}/contentherunter (siehe Die Dateien einer Version herunterladen). Lade außerdem jede nicht bereitgestellte Version, die den Test aus Schritt 2 erfüllt, anhand ihrer ID herunter. - Um Mitgliedern ein Plugin während der Prüfung zu entziehen, findest du unter Plugin löschen die umkehrbare (für Plugins der Organisation) und die dauerhafte Option.
Plugins
Das Plugin-Objekt beschreibt ein Plugin in einem der Marketplaces deiner Organisation oder im persönlichen Marketplace eines Mitglieds (die Antwort im Schnellstart zeigt ein vollständiges Objekt). Seine Felder display_name, description, manifest_version, content_scan, components und reach beschreiben seine bereitgestellte Version, sodass ein einziger Listenaufruf zeigt, was Mitgliedern bereitgestellt wird.
| Feld | Beschreibung |
|---|---|
id | Mit dem Präfix plugin_. |
name | Aus dem Manifest. Eindeutig innerhalb seines Marketplace, nicht organisationsweit. Fest für ein Plugin der Organisation; ändert sich, wenn ein Mitglied sein eigenes Plugin in claude.ai umbenennt. |
display_name, description, manifest_version | Die Manifest-Felder displayName, description und version der bereitgestellten Version; jedes ist null, wenn das Manifest keines deklariert. description kann die description eines Skills statt der des Manifests sein (nach dieser Tabelle beschrieben). manifest_version wird für die Anzeige normalisiert: Ein führendes v oder V wird entfernt, sodass eine Manifest-version von "v1.4.0" als "1.4.0" zurückgegeben wird. Es ist außerdem null bei einem Wert, der nicht wie eine Versionsnummer aussieht, etwa "latest", sowie bei einer Plugin-Version, die erstellt wurde, bevor claude.ai im August 2026 begann, dieses Feld zu erfassen. Ein Upload wird nie wegen seiner version abgelehnt, und manifest_version ist nicht eindeutig. |
served_version_id, latest_version_id | Mit dem Präfix pluginver_: die Version, die Mitgliedern bereitgestellt wird, und die neueste Version. Siehe Versionen und die bereitgestellte Version. |
served_version_pinned | false, bis das Plugin gepinnt wird (siehe Versionen und die bereitgestellte Version); ab dann true. |
owner | {"type": "organization"} oder {"type": "user", "user_id": "user_..."} für den persönlichen Marketplace eines Mitglieds. |
marketplace_id | Mit dem Präfix marketplace_. |
created_by | Wer das Plugin erstellt hat: {"type": "user_actor", "user_id": "user_...", "email_address": "..."} für eine Person in claude.ai (email_address kann null sein) oder {"type": "api_actor", "api_key_id": "apikey_..."} für einen API-Key. Andere Akteurtypen können auftreten. null, wenn kein Ersteller erfasst ist, etwa bei Plugins, die aus Git synchronisiert wurden. |
organization_installation_preference, organization_installation_preference_inherited | Plugins der Organisation: der organisationsweite Wert und ob er aus dem Standard des Marketplace stammt (siehe Installationseinstellungen). Plugins von Mitgliedern: beide null. |
content_scan | Das Scan-Ergebnis der bereitgestellten Version, ein Objekt mit status, assessment und reason (im Anschluss an diese Tabelle beschrieben). null, wenn sie nie gescannt wurde. |
components | Die Komponenten der bereitgestellten Version, jeweils {"type", "name", "description"}, wobei type einer der Werte skill, mcp_server, command, agent, hook oder cli ist, aufgelistet in dieser Typreihenfolge und dann nach Name. Bei einem MCP-Server ist name sein Schlüssel im Manifest; bei einem Hook das Ereignis, bei dem er ausgeführt wird; bei einer CLI der Name der ausführbaren Datei. description ist bei MCP-Servern, Hooks und CLIs immer null. null, wenn nicht erfasst. |
reach | contained, privileged oder remote. Siehe Reichweite. |
updated_at | Ändert sich, wenn sich die bereitgestellte Version ändert, wenn das Plugin gepinnt wird, und normalerweise, wenn eine neue Version gespeichert wird. Eine wartende Version (siehe Versionen und die bereitgestellte Version) ändert es, wenn sie zur bereitgestellten Version wird, nicht unbedingt beim Speichern. Es ändert sich nicht bei Installationseinstellungen, Freigaben oder einer alleinigen Änderung an content_scan. |
description ist nicht immer die des Manifests. Eine description, die das Manifest aus einer SKILL.md auf oberster Ebene übernimmt, wird auf ihre ersten 500 Zeichen gekürzt (siehe Anforderungen an Uploads). Wenn die description des Manifests aus den ersten 500 Zeichen genau einer eindeutigen Skill-description in components besteht, gibt die API stattdessen diese Skill-description zurück. Daraus folgt:
- Eine
description, die du liest, kann länger als 500 Zeichen sein, das Limit für ein hochgeladenes Manifest. Ein Upload, dessenplugin.jsoneine solchedescriptionsetzt, gibt400zurück. - In den Dateien, die du herunterlädst, kann
.claude-plugin/plugin.jsoneine andere oder gar keinedescriptionhaben.
Das content_scan-Objekt:
| Feld | Beschreibung |
|---|---|
status | processing, während der Scan läuft, completed, wenn er abgeschlossen ist, oder errored, wenn er nicht abgeschlossen werden konnte (oder gelegentlich, wenn sein Ergebnis für diese Antwort nicht gelesen werden konnte; in diesem Fall kann ein späterer Lesevorgang es melden). Gemeldet wird der neueste abgeschlossene Scan, falls vorhanden. Mitgliedern wird keine Version bereitgestellt, deren status processing oder errored ist; wenn du den Inhalt erneut als neue Version hochlädst, wird er neu gescannt. |
assessment | Gesetzt, wenn status completed ist: pass (nichts gefunden), warn (etwas gefunden, das die Nutzung nicht blockiert, oder ein fehlgeschlagener Scan, der in claude.ai zugelassen wurde), fail (etwas gefunden, das die Nutzung blockiert) oder unknown (kein Urteil). Andernfalls null. |
reason | Bei warn und fail das Hauptproblem aus der folgenden Liste. Andernfalls null, und ebenfalls null bei einem älteren Scan, der vor der Erfassung von Gründen durchgeführt wurde. |
reason | Bedeutung |
|---|---|
covert-usage-telemetry | Weist Claude an, Informationen über das Mitglied oder seine Nutzung an eine externe Adresse zu senden, ohne es darüber zu informieren. |
undisclosed-data-destination | Sendet Dateien, E-Mails, Dokumente oder andere Inhalte an ein festes externes Ziel, das dem Mitglied nicht angezeigt wird und das es nicht kontrolliert. |
remote-code-instruction-loader | Weist Claude an, externe Inhalte herunterzuladen und auszuführen oder deren Anweisungen zu befolgen, die sich nach der Installation des Plugins ändern können. |
credential-exposure | Enthält aktive Zugangsdaten oder sammelt Zugangsdaten oder Tokens aus der Umgebung des Mitglieds. |
guardrail-tampering | Schwächt die Schutzmaßnahmen des Mitglieds, zum Beispiel indem jede Berechtigungsabfrage vorab genehmigt wird. |
system-prompt-spoofing | Imitiert Claudes Systemanweisungen oder versucht, sie zu ersetzen. |
covert-record-tampering | Ändert, verbirgt oder löscht unbemerkt Informationen, die das Mitglied sonst sehen würde. |
covert-behavior-override | Ändert Claudes Verhalten über den Zweck des Plugins hinaus und verbirgt die Änderung vor dem Mitglied. |
hidden-code-execution | Führt mitgelieferten Code aus und weist Claude dabei an, nicht offenzulegen, was dieser tut. |
undisclosed-promotion-injection | Fügt nicht offengelegte Werbeinhalte in Claudes Ausgabe ein. |
hidden-identity-gate | Ändert oder beendet sein Verhalten abhängig davon, welches Konto es ausführt, ohne den Grund anzugeben. |
destructive-persistence | Kann die Dateien des Mitglieds löschen oder beschädigen oder Programme installieren, die nach dem Plugin bestehen bleiben. |
unanalyzable-binary | Enthält ein kompiliertes oder unlesbares Programm, sodass der Scan nicht überprüfen konnte, was es tut. |
other | Jedes andere Problem, einschließlich eines, das neuer als diese Liste ist. |
Eine plugin_id ohne das Präfix plugin_ gibt 400 zurück. Eine plugin_id, die das Präfix trägt, aber nicht im Bestand deiner Organisation enthalten ist, gibt 404 zurück.
Plugins auflisten
GET /v1/organizations/plugins listet die Plugins in deiner Organisation auf, in den Marketplaces der Organisation und in den persönlichen Marketplaces der Mitglieder, absteigend sortiert nach created_at. Filtere nach owner_type (organization oder user), owner_user_id (eine ID mit dem Präfix user_, die die Plugins eines Mitglieds findet, auch nachdem das Mitglied die Organisation verlassen hat), marketplace_id sowie created_at[gte], created_at[gt], created_at[lte], created_at[lt] (RFC-3339-Zeitstempel). Filter werden mit AND kombiniert. Eine marketplace_id oder owner_user_id, die in deiner Organisation nichts findet, gibt eine leere Seite zurück, keinen Fehler. Die Antwort hat die im Schnellstart gezeigte Form. Erfordert den Scope read:plugins.
client = anthropic.Anthropic()
plugins = client.beta.organization.plugins.list(owner_type="organization", limit=20)
# Ruft bei Bedarf automatisch weitere Seiten ab.
for plugin in plugins:
print(f"{plugin.id}: {plugin.name}")Plugin erstellen
POST /v1/organizations/plugins erstellt ein Plugin im Besitz der Organisation und seine erste Version in einem Aufruf; die Version wird zur bereitgestellten Version. Der Body ist multipart/form-data: files[] ist entweder ein einzelnes .zip- oder .plugin-Archiv oder ein Teil pro Datei, wobei der Dateiname jedes Teils der Pfad der Datei innerhalb des Plugins ist (zum Beispiel .claude-plugin/plugin.json). Optionale Felder sind marketplace_id (ein manual-Marketplace im Besitz der Organisation oder standardmäßig dein Bibliotheks-Marketplace, der bei der ersten Verwendung erstellt wird) und release_notes (bis zu 5.000 Zeichen, angezeigt im Versionsverlauf von claude.ai und bei der Version zurückgegeben). Die Felder name, display_name, description und manifest_version des Plugins stammen aus den hochgeladenen Dateien, und der Upload muss die Upload-Anforderungen erfüllen. Wenn das Content-Scanning aktiviert ist, ist content_scan.status in der Antwort processing, und das Urteil kommt asynchron. Gibt das Plugin zurück. Erfordert den Scope write:plugins.
Ein Archiv hochladen:
client = anthropic.Anthropic()
with open("dist/sales-toolkit.zip", "rb") as archive:
plugin = client.beta.organization.plugins.create(
files=[archive],
release_notes="First release",
)
print(f"id: {plugin.id}")
print(f"served_version_id: {plugin.served_version_id}"){
"type": "plugin",
"id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
"name": "sales-toolkit",
"display_name": "Sales Toolkit",
"description": "Account research and call prep for the sales team.",
"served_version_id": "pluginver_01Km7tL4pR9xF5sU2zV3jP6q",
"served_version_pinned": false,
"latest_version_id": "pluginver_01Km7tL4pR9xF5sU2zV3jP6q",
"manifest_version": "1.4.0",
"owner": { "type": "organization" },
"marketplace_id": "marketplace_01Lp8uM5qS1yG6tV3aW4kQ7r",
"created_by": { "type": "api_actor", "api_key_id": "apikey_01Nq9vN6rT2zH7uW4bX5mR8s" },
"organization_installation_preference": "available",
"organization_installation_preference_inherited": true,
"content_scan": { "status": "processing", "assessment": null, "reason": null },
"components": [
{
"type": "skill",
"name": "account-research",
"description": "Researches a customer account before a call."
},
{ "type": "mcp_server", "name": "crm", "description": null }
],
"reach": "remote",
"created_at": "2026-09-01T17:04:11Z",
"updated_at": "2026-09-01T17:04:11Z"
}Einzelne Dateien in einen benannten Marketplace hochladen. Hänge jede Datei unter ihrem Pfad innerhalb des Plugins an (das Suffix ;filename= im cURL-Beispiel, die Dateinamen-Argumente in den SDK-Beispielen); eine Datei, die nur unter ihrem Basisnamen gesendet wird, führt dazu, dass das Manifest nicht gefunden wird. Die TypeScript- und Java-SDKs sowie die ant-CLI können Dateien noch nicht unter einem Pfad anhängen, daher laden diese Beispiele das Plugin stattdessen als ein Archiv in den Marketplace hoch:
client = anthropic.Anthropic()
# Ein (filename, file)-Tupel behält den Pfad jeder Datei im Plugin bei;
# ein reines Dateiobjekt würde nur unter seinem Basisnamen gesendet.
with (
open(".claude-plugin/plugin.json", "rb") as manifest,
open("skills/account-research/SKILL.md", "rb") as skill_md,
):
plugin = client.beta.organization.plugins.create(
files=[
(".claude-plugin/plugin.json", manifest),
("skills/account-research/SKILL.md", skill_md),
],
marketplace_id="marketplace_01Lp8uM5qS1yG6tV3aW4kQ7r",
)
print(f"id: {plugin.id}")
print(f"served_version_id: {plugin.served_version_id}")Neben einem 400 für einen Upload, der gegen die Upload-Anforderungen verstößt (413 für einen Request-Body über 200 MB), und den gemeinsamen Antworten (ein 403, wenn marketplace_id der persönliche Marketplace eines Mitglieds ist; siehe Fehlerantworten) kann ein Erstellen fehlschlagen mit:
| Status | Ursache | Vorgehen |
|---|---|---|
| 404 | marketplace_id ist kein Marketplace deiner Organisation. | Entnimm die ID aus Marketplaces auflisten. |
| 400 | Der Marketplace wird aus Git synchronisiert oder enthält bereits 1.000 Plugins (siehe Anforderungen an Uploads). | Lade in einen anderen manual-Marketplace hoch oder ändere stattdessen das Repository. |
409 plugin_name_taken | Der Name ist in diesem Marketplace bereits vergeben. | Lade nur dann eine Version zu details.plugin_id hoch, wenn es das Plugin ist, das du aktualisieren wolltest, denn jemand anderes könnte es erstellt haben. Andernfalls oder wenn details.plugin_id fehlt, lade unter einem anderen Namen hoch (ändere den name im Manifest). |
409 skill_name_taken | Das Plugin kommt in den Bibliotheks-Marketplace, und einer seiner Skills trägt den Namen eines Organisations-Skills. | Benenne den Skill um oder entferne den Organisations-Skill in claude.ai. |
409 (kein error_code) | Ein anderer Upload mit demselben Namen in denselben Marketplace läuft, oder ein Plugin, das diese API nicht auflistet, belegt den Namen. | Versuche es mit Backoff erneut. Wenn der 409 länger als einige Minuten bestehen bleibt, lade unter einem anderen Namen hoch (ändere den name im Manifest). |
503 registration_pending | Das Plugin wurde erstellt, aber seine Registrierung wurde nicht abgeschlossen. | Sende die Anfrage nicht erneut; lade dieselben Dateien als Version von details.plugin_id hoch (siehe Uploads wiederholen). |
Plugin abrufen
GET /v1/organizations/plugins/{plugin_id} gibt ein Plugin zurück. Erfordert den Scope read:plugins.
client = anthropic.Anthropic()
plugin = client.beta.organization.plugins.retrieve("plugin_01Hq3vX8kZcN2mB7pR4tY9wL")
print(f"id: {plugin.id}")
print(f"name: {plugin.name}")Bereitgestellte Version ändern
POST /v1/organizations/plugins/{plugin_id} ändert, welche Version eines Plugins im Besitz der Organisation Mitgliedern bereitgestellt wird. Übergib eine frühere Version, um zurückzurollen, oder eine neuere, um einen Build hochzustufen, der gespeichert, aber nicht bereitgestellt wurde. Dadurch wird das Plugin gepinnt, und ein gepinntes Plugin kann nicht entpinnt werden, weder hier noch in claude.ai (siehe Versionen und die bereitgestellte Version). Das einzige aktualisierbare Feld ist served_version_id, und es ist erforderlich. Die Änderung erreicht die Mitglieder, bevor die Antwort zurückkommt, und erstellt keine Version. Wenn das Content-Scanning aktiviert ist, muss die Version eine sein, die Mitgliedern bereitgestellt werden kann (siehe Content-Scanning). Die Übergabe der bereits bereitgestellten Version bei einem gepinnten Plugin ändert nichts; bei einem nicht gepinnten Plugin wird es damit auf diese Version gepinnt, sodass spätere Uploads nicht mehr automatisch bereitgestellt werden. Das Pinnen beendet auch jedes Warten: Eine Version, die auf ihren Content-Scan gewartet hat, bleibt gespeichert und wird nur bereitgestellt, wenn jemand sie auswählt. Gibt das Plugin zurück. Erfordert den Scope write:plugins.
client = anthropic.Anthropic()
plugin = client.beta.organization.plugins.update(
"plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
served_version_id="pluginver_01Jd5sK2nQ8wE4rT6yU1iO3p",
)
print(f"id: {plugin.id}")
print(f"served_version_id: {plugin.served_version_id}"){
"type": "plugin",
"id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
"name": "sales-toolkit",
"display_name": "Sales Toolkit",
"description": "Account research and call prep for the sales team.",
"served_version_id": "pluginver_01Jd5sK2nQ8wE4rT6yU1iO3p",
"served_version_pinned": true,
"latest_version_id": "pluginver_01Jd5sK2nQ8wE4rT6yU1iO3p",
"manifest_version": "1.5.0",
"owner": { "type": "organization" },
"marketplace_id": "marketplace_01Lp8uM5qS1yG6tV3aW4kQ7r",
"created_by": { "type": "api_actor", "api_key_id": "apikey_01Nq9vN6rT2zH7uW4bX5mR8s" },
"organization_installation_preference": "available",
"organization_installation_preference_inherited": true,
"content_scan": { "status": "completed", "assessment": "pass", "reason": null },
"components": [
{
"type": "skill",
"name": "account-research",
"description": "Researches a customer account before a call."
},
{ "type": "mcp_server", "name": "crm", "description": null },
{
"type": "command",
"name": "call-prep",
"description": "Builds a one-page brief for an upcoming call."
}
],
"reach": "remote",
"created_at": "2026-09-01T17:04:11Z",
"updated_at": "2026-09-16T10:02:45Z"
}Neben den gemeinsamen Antworten (ein 403 für ein Plugin im Besitz eines Mitglieds sowie 409 scan_pending oder 400 scan_failed für eine Version, die Mitgliedern nicht bereitgestellt werden kann; siehe Fehlerantworten) kann die Anfrage fehlschlagen mit:
| Status | Ursache | Vorgehen |
|---|---|---|
| 400 | Der Body lässt served_version_id weg, setzt es auf null oder enthält ein anderes Feld; oder dem Wert fehlt das Präfix pluginver_ oder er ist latest. | Sende genau {"served_version_id": "pluginver_..."}. |
| 404 | served_version_id ist keine Version dieses Plugins. | Entnimm die ID aus Versionen eines Plugins auflisten. |
409 (kein error_code) | Ein Upload zu diesem Plugin oder eine andere Änderung der bereitgestellten Version läuft noch. | Versuche es in Kürze erneut. |
409 skill_name_taken | Das Plugin befindet sich im Bibliotheks-Marketplace, und die Version enthält einen Skill, dessen Namen inzwischen ein Organisations-Skill verwendet. | Wähle eine andere Version oder benenne einen der Skills um. |
Plugin löschen
DELETE /v1/organizations/plugins/{plugin_id} löscht ein Plugin und alle seine Versionen dauerhaft, genau wie das Löschen durch einen Administrator in claude.ai. Es funktioniert für jedes Plugin in einem manual-Marketplace, einschließlich des Plugins eines Mitglieds, selbst wenn dieses Mitglied die Organisation inzwischen verlassen hat. Wenn das Löschen zurückkehrt, sind das Plugin, seine Versionen und deren Dateien aus allen Lesezugriffen verschwunden, und es wird Mitgliedern nicht mehr bereitgestellt. Die Installationseinstellungen eines Plugins im Besitz der Organisation werden mit ihm entfernt; die Freigaben eines Plugins im Besitz eines Mitglieds werden zurückgezogen, und es verschwindet auch für seinen Eigentümer. Ein Plugin in einem aus Git synchronisierten Marketplace gibt 400 zurück: Entferne es aus dem Repository oder entferne den Marketplace in claude.ai. Erfordert den Scope write:plugins.
Das Löschen kann nicht rückgängig gemacht werden, und es gibt kein Löschen pro Version. Um ein Plugin im Besitz der Organisation stattdessen umkehrbar zurückzuhalten, setze seine organisationsweite Installationseinstellung auf not_available (ein Plugin, das den Standard seines Marketplace geerbt hat, erhält eine eigene Einstellung, und das Entfernen dieser organisationsweiten Einstellung bringt das Plugin später zum Standard zurück), und entferne jede Gruppeneinstellung, die GET /v1/organizations/plugins/{plugin_id}/installation_settings auflistet (oder setze sie auf not_available), da die Einstellung einer Gruppe den organisationsweiten Wert für ihre Mitglieder überschreibt. Sende diese Schreibvorgänge nacheinander, nicht parallel (siehe Installationseinstellung festlegen). Ein Plugin im Besitz eines Mitglieds kann über diese API nur durch Löschen zurückgehalten werden, und nur, wenn sein Marketplace manual ist.
client = anthropic.Anthropic()
deleted_plugin = client.beta.organization.plugins.delete(
"plugin_01Hq3vX8kZcN2mB7pR4tY9wL"
)
print(f"id: {deleted_plugin.id}"){ "type": "plugin_deleted", "id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL" }Plugin-Versionen
Eine Plugin-Version ist ein unveränderlicher Snapshot der Dateien eines Plugins aus einem Upload (die Antwort von Version erstellen zeigt ein vollständiges Objekt). Ihre Felder spiegeln die Felder der bereitgestellten Version des Plugins (display_name, description, manifest_version, content_scan, components, reach) für diese Version wider, zuzüglich release_notes (wie beim Upload angegeben und im Versionsverlauf von claude.ai angezeigt) und created_by (wer sie hochgeladen hat).
Eine {version} ohne das Präfix pluginver_ gibt 400 zurück (außer dem Literal latest, wo angegeben). Eine, die das Präfix trägt, aber keine Version dieses Plugins bezeichnet, gibt 404 zurück.
Versionen eines Plugins auflisten
GET /v1/organizations/plugins/{plugin_id}/versions listet die Versionen eines Plugins auf, absteigend nach created_at sortiert; das erste Element ist die Version, die latest_version_id bezeichnet. limit liegt zwischen 1 und 1.000. Erfordert den Scope read:plugins.
client = anthropic.Anthropic()
versions = client.beta.organization.plugins.versions.list(
"plugin_01Hq3vX8kZcN2mB7pR4tY9wL", limit=50
)
# Ruft bei Bedarf automatisch weitere Seiten ab.
for version in versions:
print(f"{version.id}: {version.manifest_version}")Version erstellen
POST /v1/organizations/plugins/{plugin_id}/versions fügt einem Plugin im Besitz der Organisation in einem manual-Marketplace eine Version hinzu. Der Body ist multipart/form-data, mit denselben Feldern files[] und release_notes, denselben Upload-Anforderungen sowie denselben Datei-, Manifest-, Archiv- und Größenfehlern wie bei Plugin erstellen. Der hochgeladene Name (der name des Manifests) muss dem name des Plugins entsprechen. Wenn das Plugin nicht gepinnt ist, wird die neue Version normalerweise bereitgestellt, sobald sie gespeichert ist; wenn es gepinnt ist, wird die Version gespeichert, aber nicht bereitgestellt, bis du die bereitgestellte Version auf sie änderst. Vergleiche zur Überprüfung die id der Antwort mit der served_version_id des Plugins. Gibt die Version zurück. Erfordert den Scope write:plugins.
client = anthropic.Anthropic()
with open("dist/sales-toolkit.zip", "rb") as archive:
version = client.beta.organization.plugins.versions.create(
"plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
files=[archive],
release_notes="Adds the call-prep command.",
)
print(f"id: {version.id}")
print(f"manifest_version: {version.manifest_version}"){
"type": "plugin_version",
"id": "pluginver_01Jd5sK2nQ8wE4rT6yU1iO3p",
"plugin_id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
"display_name": "Sales Toolkit",
"description": "Account research and call prep for the sales team.",
"manifest_version": "1.5.0",
"release_notes": "Adds the call-prep command.",
"created_by": { "type": "api_actor", "api_key_id": "apikey_01Nq9vN6rT2zH7uW4bX5mR8s" },
"content_scan": { "status": "processing", "assessment": null, "reason": null },
"components": [
{
"type": "skill",
"name": "account-research",
"description": "Researches a customer account before a call."
},
{ "type": "mcp_server", "name": "crm", "description": null },
{
"type": "command",
"name": "call-prep",
"description": "Builds a one-page brief for an upcoming call."
}
],
"reach": "remote",
"created_at": "2026-09-15T14:12:30Z"
}Neben einem 400 für einen Upload, der gegen die Upload-Anforderungen verstößt (413 für einen Request-Body über 200 MB), und den gemeinsamen Antworten (ein 403 für ein Plugin im Besitz eines Mitglieds; siehe Fehlerantworten) kann die Anfrage fehlschlagen mit:
| Status | Ursache | Vorgehen |
|---|---|---|
| 400 | Das Plugin befindet sich in einem aus Git synchronisierten Marketplace, oder der hochgeladene Name weicht von dem des Plugins ab. | Ändere stattdessen das Repository oder korrigiere den name im Manifest. |
409 (kein error_code) | Ein anderer Upload zu diesem Plugin oder eine Änderung der bereitgestellten Version läuft noch. | Versuche es in Kürze erneut. |
409 skill_name_taken | Das Plugin befindet sich im Bibliotheks-Marketplace, und die Version fügt einen Skill mit dem Namen eines Organisations-Skills hinzu. | Benenne den Skill um oder entferne den Organisations-Skill in claude.ai. |
503 registration_pending | Die Version wurde gespeichert, aber ihre Registrierung wurde nicht abgeschlossen. | Sende dieselbe Anfrage erneut, wenn die Antwort x-should-retry: true enthält (siehe Uploads wiederholen). |
Version abrufen
GET /v1/organizations/plugins/{plugin_id}/versions/{version} gibt eine Version zurück. {version} ist eine Versions-ID oder latest für die Version, die latest_version_id zum Zeitpunkt der Anfrage bezeichnet. Erfordert den Scope read:plugins.
client = anthropic.Anthropic()
version = client.beta.organization.plugins.versions.retrieve(
"latest",
plugin_id="plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
)
print(f"id: {version.id}")
print(f"manifest_version: {version.manifest_version}")Dateien einer Version herunterladen
GET /v1/organizations/plugins/{plugin_id}/versions/{version}/content lädt die Dateien einer Version als das gespeicherte .zip-Archiv herunter (Content-Type: application/zip). Das Archiv wird unabhängig vom Ergebnis des Content-Scans zurückgegeben, sodass du Versionen untersuchen kannst, die Mitgliedern vorenthalten werden. Es wird genau so ausgeliefert, wie es gespeichert ist, sodass du es bei einem Plugin im Besitz der Organisation in einem manual-Marketplace unverändert als neue Version erneut hochladen kannst, sofern es die aktuellen Upload-Anforderungen erfüllt. {version} muss eine Versions-ID sein, nicht latest: Lies zuerst die served_version_id oder latest_version_id des Plugins oder löse latest mit GET /v1/organizations/plugins/{plugin_id}/versions/latest auf. Der Dateiname in Content-Disposition wird vom Namen des Plugins abgeleitet und ist nicht eindeutig; benenne gespeicherte Dateien nach Plugin- und Versions-ID. Erfordert den Scope read:plugins.
Das Herunterladen des Archivs eines Plugins im Besitz eines Mitglieds erzeugt ein claude_plugin_archive_accessed-Ereignis im Activity Feed der Compliance API, das den Key (als api_actor), das Plugin und seinen Marketplace, die Version und das besitzende Mitglied per ID identifiziert; es enthält keine Namen. Das Herunterladen des Archivs eines Plugins im Besitz der Organisation erzeugt keinen Eintrag.
client = anthropic.Anthropic()
plugin_id = "plugin_01Hq3vX8kZcN2mB7pR4tY9wL"
version_id = "pluginver_01Km7tL4pR9xF5sU2zV3jP6q"
with client.beta.organization.plugins.versions.with_streaming_response.download(
version_id,
plugin_id=plugin_id,
) as response:
response.stream_to_file(f"{plugin_id}_{version_id}.zip")Plugin-Installationseinstellungen
Diese Endpunkte gelten für Plugins im Besitz der Organisation. Sie geben 404 für ein Plugin im Besitz eines Mitglieds zurück, das stattdessen Freigaben hat (siehe Plugin-Freigaben). {target} ist das Literal organization für die organisationsweite Einstellung des Plugins oder die rbac_group_-ID einer Gruppe für die Einstellung dieser Gruppe; jeder andere Wert gibt 400 zurück. Gruppen-IDs stammen aus GET /v1/organizations/rbac_groups (Scope read:rbac_groups; siehe Gruppen in der Benutzerverwaltung). Eine Einstellung hat keine eigene id: Sie wird über (plugin_id, target) adressiert, und es wird kein Akteur darauf erfasst (der Akteur befindet sich in ihrem Aktivitätsereignis plugin_installation_preference_updated).
Installationseinstellungen eines Plugins auflisten
GET /v1/organizations/plugins/{plugin_id}/installation_settings listet die Einstellungen eines Plugins im Besitz der Organisation auf, absteigend nach created_at sortiert: seine eigene organisationsweite Einstellung (fehlt, solange es den Standard seines Marketplace erbt) und die Einstellung jeder Gruppe. Filtere nach target_type (organization oder rbac_group). Erfordert den Scope read:plugins.
client = anthropic.Anthropic()
settings = client.beta.organization.plugins.installation_settings.list(
"plugin_01Hq3vX8kZcN2mB7pR4tY9wL"
)
# Ruft bei Bedarf automatisch weitere Seiten ab.
for setting in settings:
print(f"{setting.plugin_id}: {setting.installation_preference}")Installationseinstellung festlegen
POST /v1/organizations/plugins/{plugin_id}/installation_settings/{target} legt die Installationseinstellung eines Ziels für ein Plugin im Besitz der Organisation fest, indem sie erstellt oder der bereits vorhandene Wert geändert wird. Das einzige Feld des Bodys ist installation_preference (required, auto_install, available oder not_available), und es ist erforderlich. Das Festlegen des Werts, den das Ziel bereits hat, ändert nichts. Das Festlegen des Ziels organization beendet das Erben des Marketplace-Standards durch das Plugin (organization_installation_preference_inherited wird false), selbst wenn der Wert dem Standard entspricht, sodass das Plugin späteren Änderungen am Marketplace-Standard nicht mehr folgt. Um das Plugin zum Standard seines Marketplace zurückzubringen, entferne die organisationsweite Einstellung; Gruppeneinstellungen sind davon nicht betroffen. Ein Gruppenziel muss eine Gruppe sein, die deine Organisation in GET /v1/organizations/rbac_groups sehen kann, andernfalls gibt die Anfrage 404 zurück. Die Änderung verändert nicht das updated_at des Plugins; sie wird im Activity Feed aufgezeichnet. Gibt die Einstellung zurück. Erfordert den Scope write:plugins.
Sende die Schreibvorgänge für Installationseinstellungen eines Plugins einzeln nacheinander. Treffen mehrere Schreibvorgänge für dasselbe Plugin gleichzeitig ein, verarbeitet der Server sie nacheinander und kann einige davon mit 503 beantworten, statt sie anzuwenden. Dieses 503 enthält x-should-retry: true, und der Schreibvorgang kann gefahrlos wiederholt werden: Warte ein bis zwei Sekunden und sende ihn dann erneut.
client = anthropic.Anthropic()
setting = client.beta.organization.plugins.installation_settings.set(
"rbac_group_01F3xQqQzXyWvUtSrQpOnMlK",
plugin_id="plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
installation_preference="available",
)
print(f"plugin_id: {setting.plugin_id}")
print(f"installation_preference: {setting.installation_preference}"){
"type": "plugin_installation_setting",
"plugin_id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
"target": { "type": "rbac_group", "rbac_group_id": "rbac_group_01F3xQqQzXyWvUtSrQpOnMlK" },
"installation_preference": "available",
"created_at": "2026-09-02T10:00:00Z",
"updated_at": "2026-09-02T10:00:00Z"
}Installationseinstellung entfernen
DELETE /v1/organizations/plugins/{plugin_id}/installation_settings/{target} entfernt die Installationseinstellung eines Ziels für ein Plugin im Besitz der Organisation. Mit {target} gleich organization entfernt es die eigene organisationsweite Einstellung des Plugins. Das Plugin erbt dann wieder den Standard seines Marketplace (organization_installation_preference_inherited wird true) und folgt späteren Änderungen an diesem Standard; Gruppeneinstellungen sind davon nicht betroffen. Mit der rbac_group_-ID einer Gruppe entfernt es die Einstellung dieser Gruppe: Die Mitglieder der Gruppe fallen auf den organisationsweiten Wert oder auf die Einstellung einer anderen ihrer Gruppen zurück. Ein Ziel, das keine eigene Einstellung hat, gibt 404 zurück; das schließt das Ziel organization eines Plugins ein, das bereits den Standard seines Marketplace erbt. Die Änderung verändert nicht das updated_at des Plugins; sie wird im Activity Feed aufgezeichnet. Die Antwort enthält den zusammengesetzten Schlüssel anstelle einer id; für das Ziel organization ist ihr target {"type": "organization"}. Erfordert den Scope write:plugins.
client = anthropic.Anthropic()
removed_setting = client.beta.organization.plugins.installation_settings.remove(
"rbac_group_01F3xQqQzXyWvUtSrQpOnMlK",
plugin_id="plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
)
print(f"plugin_id: {removed_setting.plugin_id}"){
"type": "plugin_installation_setting_deleted",
"plugin_id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
"target": { "type": "rbac_group", "rbac_group_id": "rbac_group_01F3xQqQzXyWvUtSrQpOnMlK" }
}Plugin-Freigaben
Freigaben gibt es nur bei Plugins im Besitz von Mitgliedern, und sie sind in dieser API schreibgeschützt (siehe Freigaben).
Freigaben eines Plugins auflisten
GET /v1/organizations/plugins/{plugin_id}/shares listet auf, für wen der Eigentümer eines Plugins im Besitz eines Mitglieds es freigegeben hat, absteigend nach granted_at sortiert: alle Mitglieder (organization), eine Gruppe (rbac_group) oder ein namentlich genanntes Mitglied (organization_member). Filtere nach target_type. Ein Plugin, das sein Eigentümer nicht freigegeben hat, gibt eine leere Liste zurück; ein Plugin im Besitz der Organisation gibt 404 zurück. Freigaben sind in dieser API schreibgeschützt, und eine aufgelistete Freigabe gewährt nur Zugriff, solange diese Art der Freigabe für deine Organisation in claude.ai aktiviert ist (siehe Freigaben). granted_at ist der Zeitpunkt, zu dem die Freigabe erteilt wurde; ändert der Eigentümer die Freigabe später in claude.ai, ist es der Zeitpunkt dieser Änderung. Erfordert den Scope read:plugins.
client = anthropic.Anthropic()
shares = client.beta.organization.plugins.shares.list("plugin_01Mr2wP7sU3aJ8vX5cY6nS9t")
# Ruft bei Bedarf automatisch weitere Seiten ab.
for share in shares:
print(f"plugin_id: {share.plugin_id}"){
"data": [
{
"type": "plugin_share",
"plugin_id": "plugin_01Mr2wP7sU3aJ8vX5cY6nS9t",
"target": { "type": "organization_member", "user_id": "user_01WCz9BvGLdMYRUMmcAxMWvW" },
"granted_at": "2026-08-20T15:12:00Z"
}
],
"next_page": null
}Plugin-Marketplaces
Diese API liest Marketplaces und legt die Standard-Installationseinstellung eines Organisations-Marketplace fest; die Marketplaces selbst werden in claude.ai erstellt, mit einem Repository verbunden und gelöscht.
{
"type": "plugin_marketplace",
"id": "marketplace_01VbNcMxZaSdFgHjKlQwErTy",
"name": "engineering-tools",
"owner": { "type": "organization" },
"source": "github",
"sync_status": "success",
"last_sync_ended_at": "2026-09-10T22:15:03Z",
"last_sync_read_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8",
"default_installation_preference": "available",
"created_at": "2026-06-12T08:45:00Z"
}| Feld | Beschreibung |
|---|---|
name | Der Name des Marketplace. Bleibt während seiner gesamten Lebensdauer unverändert. |
owner | Gleiche Struktur wie beim Plugin. |
source | manual, github, gitlab oder public_git. Siehe Marketplaces. |
sync_status | Ergebnis der letzten Synchronisierung: success, in_progress, failed_content, failed_transient, failed_auth oder failed_limits. null, bis zum ersten Mal eine Synchronisierung versucht wird, was bei einem Marketplace mit der Quelle manual nie geschieht. |
last_sync_ended_at | Wann der letzte Synchronisierungsversuch abgeschlossen wurde, unabhängig von seinem Ergebnis; bei einem verbundenen Repository, das noch nicht synchronisiert wurde, der Zeitpunkt, zu dem der Marketplace erstellt wurde. null für einen Marketplace, der nicht synchronisiert wird. |
last_sync_read_sha | Der Commit, den die letzte Synchronisierung aus dem Repository gelesen hat. Nicht unbedingt der Commit, aus dem die bereitgestellten Versionen stammen. null für einen Marketplace, der nicht synchronisiert wird. |
default_installation_preference | Organisations-Marketplaces: der organisationsweite Wert für jedes darin enthaltene Plugin ohne eigene Einstellung (not_available, falls nie gesetzt). Persönliche Marketplaces: null. |
Eine marketplace_id ohne das Präfix marketplace_ gibt 400 zurück. Eine, die das Präfix trägt, aber nicht aufgelöst werden kann oder zu einer anderen Organisation gehört, gibt 404 zurück.
Marketplaces auflisten
GET /v1/organizations/plugin_marketplaces listet die Marketplaces deiner Organisation und die persönlichen Marketplaces der Mitglieder auf, absteigend nach created_at sortiert. Verwende diesen Endpunkt, um die ID eines Marketplace zu ermitteln, damit du die Plugin-Liste danach filtern oder in ihn hochladen kannst, noch bevor er ein Plugin enthält. Der Bibliotheks-Marketplace erscheint, sobald darin erstmals etwas erstellt wurde, in claude.ai oder über diese API. Filtere nach owner_type (organization oder user) und source. limit liegt zwischen 1 und 1.000. Erfordert den Scope read:plugins.
client = anthropic.Anthropic()
marketplaces = client.beta.organization.plugin_marketplaces.list(
owner_type="organization"
)
# Ruft bei Bedarf automatisch weitere Seiten ab.
for marketplace in marketplaces:
print(f"{marketplace.id}: {marketplace.name}")Marketplace abrufen
GET /v1/organizations/plugin_marketplaces/{marketplace_id} gibt einen Marketplace zurück. Erfordert den Scope read:plugins.
client = anthropic.Anthropic()
marketplace = client.beta.organization.plugin_marketplaces.retrieve(
"marketplace_01Lp8uM5qS1yG6tV3aW4kQ7r"
)
print(f"id: {marketplace.id}")
print(f"name: {marketplace.name}")Standard-Installationseinstellung eines Marketplace festlegen
POST /v1/organizations/plugin_marketplaces/{marketplace_id} legt die Standard-Installationseinstellung eines Marketplace im Besitz der Organisation fest. Jedes Plugin im Marketplace ohne eigene organisationsweite Einstellung meldet diesen Standard als seine organization_installation_preference, einschließlich später hinzugefügter Plugins. Dies funktioniert für manual- und synchronisierte Marketplaces; der persönliche Marketplace eines Mitglieds gibt 403 zurück. Das einzige aktualisierbare Feld ist default_installation_preference, und es ist erforderlich. Es kann nicht wieder auf null gesetzt werden: Sobald ein Marketplace einen Standard hat, behält er einen, wie in claude.ai. Eine Änderung wird als ein einzelnes marketplace_updated-Ereignis ohne Ereignisse pro Plugin erfasst und verändert updated_at keines Plugins. Das Setzen des bereits gesetzten Werts ändert nichts, mit einer Ausnahme: Ein Marketplace, dessen Standard nie gesetzt wurde, meldet not_available, hat aber keine Einstellung, sodass sein erster Schreibvorgang (selbst not_available) als Änderung zählt. Gibt den Marketplace zurück. Erfordert den Scope write:plugins.
client = anthropic.Anthropic()
marketplace = client.beta.organization.plugin_marketplaces.update(
"marketplace_01Lp8uM5qS1yG6tV3aW4kQ7r",
default_installation_preference="available",
)
print(f"id: {marketplace.id}")
print(f"default_installation_preference: {marketplace.default_installation_preference}")Marketplace-Inhalte validieren
Zwei Endpunkte melden, was eine Synchronisierung der angegebenen Marketplace-Inhalte bewirken würde, ohne etwas zu verbinden oder zu speichern: POST /v1/organizations/plugin_marketplaces/validate_repository liest ein öffentliches GitHub-Repository, und POST /v1/organizations/plugin_marketplaces/validate_archive liest eine .zip-Datei des Marketplace-Verzeichnisses, die du hochlädst. Beide geben denselben Bericht zurück: ob marketplace.json wohlgeformt ist, welche Plugins übersprungen würden und warum, und welche Plugins synchronisiert würden, wobei einige Inhalte ausgelassen werden. Die Prüfungen sind dieselben, die eine echte Synchronisierung ausführt. Probleme mit dem Inhalt werden im Bericht zurückgegeben, nicht als HTTP-Fehler: Die Anfrage ist mit valid: false erfolgreich, selbst wenn das Repository oder Archiv überhaupt nicht gelesen werden kann. Eine Validierung zählt als Lesevorgang, und die beiden Endpunkte zusammen sind zusätzlich auf 10 Validierungen pro Minute für jede Organisation begrenzt (siehe Ratenlimits); sie zeichnen nichts im Activity Feed auf. Eine Validierung kann bis zu 120 Sekunden dauern, bevor sie zurückkehrt, setze daher das Timeout deines Clients auf einen höheren Wert. Beide Endpunkte erfordern den Scope read:plugins oder write:plugins (read:org_audit und read:compliance_org_data gewähren diese nicht).
Die Validierung liest das Repository anonym. Dasselbe gilt für jede Plugin-Quelle, die sich auf GitHub, aber außerhalb des Repositorys befindet. Infolgedessen meldet die Validierung ein privates Repository oder eine private Plugin-Quelle als nicht gefunden oder als eine GitHub-Anmeldung erfordernd. Wenn die Validierung meldet, dass eine GitHub-Anmeldung erforderlich ist, lautet der Berichtscode marketplace_repo_sign_in_required.
Die Validierung ruft keine Plugin-Quellen auf anderen Hosts als GitHub ab. Ein Plugin mit einer solchen Quelle erhält normalerweise eine Warnung marketplace_validate_source_not_checked und wird geprüft, wenn der Marketplace tatsächlich synchronisiert wird.
Die Validierung wendet strengere Regeln auf einen Marketplace an, den Anthropic in jede Organisation synchronisiert. validate_repository wendet sie an, wenn das Repository ein solcher Marketplace ist. validate_archive wendet sie an, wenn das Archiv einen solchen Marketplace benennt. Die strengeren Regeln lauten wie folgt:
- Jede Plugin-Quelle außerhalb des Marketplace muss auf einen vollständigen Commit-SHA festgelegt sein.
- Die Validierung meldet nicht festgelegte Quellen und Quellen auf nicht unterstützten Hosts als Plugin-Fehler.
- Bei
validate_repositoryist der Branch, den die Validierung liest, standardmäßig der Branch, von dem aus der Marketplace synchronisiert wird.
validate_repository akzeptiert einen JSON-Body mit zwei Feldern: repository_url, die https://-URL eines öffentlichen Repositorys auf github.com (erforderlich), und ref, ein Branch-Name oder ein vollständiger 40-stelliger Commit-SHA (optional). Wenn ref weggelassen wird oder null ist, wird standardmäßig der Branch verwendet, den eine Synchronisierung lesen würde, normalerweise der Standard-Branch des Repositorys. validate_archive akzeptiert multipart/form-data mit genau einem Teil, archive, gesendet als Dateiteil mit einem Dateinamen. Die Datei ist eine .zip-Datei des Marketplace-Verzeichnisses, höchstens 32 MB groß, die nur DEFLATE- oder STORE-Komprimierung verwendet. Der Inhalt des Archivs liegt im Stammverzeichnis oder ist in einen Ordner eingebettet (wie ihn der Download eines Git-Hosts erzeugt). Kein anderes Formularfeld wird akzeptiert.
Ein öffentliches Repository auf einem Branch validieren:
client = anthropic.Anthropic()
report = client.beta.organization.plugin_marketplaces.validate_repository(
repository_url="https://github.com/example-org/claude-plugins",
ref="release-candidate",
)
print(f"valid: {str(report.valid).lower()}")
print(f"total_plugin_count: {report.total_plugin_count}"){
"type": "plugin_marketplace_validation_report",
"valid": false,
"ref": "release-candidate",
"commit_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8",
"total_plugin_count": 3,
"manifest_error": null,
"manifest_error_code": null,
"plugin_errors": [
{
"name": "deploy-helper",
"error": "The plugin has a top-level bin/ directory.",
"error_code": "marketplace_sync_bin_directory_not_allowed"
}
],
"plugin_warnings": [
{
"name": "release-notes",
"warnings": [
{
"message": "plugin.json has unrecognized top-level keys: owners",
"error_code": "marketplace_sync_plugin_unrecognized_keys"
}
]
}
]
}| Feld | Beschreibung |
|---|---|
valid | true, wenn marketplace.json wohlgeformt ist und kein Plugin übersprungen würde. Warnungen machen es nicht zu false. |
ref | Der gelesene Branch, mit Namen; null, wenn kein Branch angegeben und der Standard-Branch gelesen wurde, bei einem Commit-SHA oder bei einem Archiv. |
commit_sha | Der validierte Commit. Bei einem von einem Git-Host heruntergeladenen Archiv der Commit, den der Host im Kommentarfeld der ZIP-Datei vermerkt hat, falls vorhanden (nicht verifiziert). |
total_plugin_count | Wie viele Plugins marketplace.json deklariert; 0, wenn sie nicht gelesen werden konnte. |
manifest_error, manifest_error_code | Gesetzt, wenn nichts validiert werden konnte: Die Quelle konnte nicht gelesen werden, oder marketplace.json fehlt, ist fehlerhaft oder überschreitet ein Limit. Eine Validierung, die nicht innerhalb von 120 Sekunden abgeschlossen wurde, meldet manifest_error_code: "marketplace_validate_deadline_exceeded". |
plugin_errors | Ein {name, error, error_code} pro Plugin, das eine Synchronisierung überspringen würde. |
plugin_warnings | Ein {name, warnings: [{message, error_code}]} pro Plugin, das synchronisiert würde, wobei einige Inhalte ausgelassen würden. |
Validiere stattdessen eine lokale Kopie des Marketplace-Verzeichnisses als .zip; die Antwort ist derselbe Bericht:
client = anthropic.Anthropic()
with open("marketplace.zip", "rb") as archive:
report = client.beta.organization.plugin_marketplaces.validate_archive(
archive=archive
)
print(f"valid: {str(report.valid).lower()}")
print(f"total_plugin_count: {report.total_plugin_count}")Probleme mit den Inhalten lassen die Anfrage nie fehlschlagen. Abgesehen von den Antworten, die alle Endpunkte gemeinsam haben (ein 403 für einen Key, der nur read:org_audit oder read:compliance_org_data hat; siehe Fehlerantworten und Ratenlimits), kann die Anfrage selbst fehlschlagen mit:
| Status | Ursache | Vorgehen |
|---|---|---|
| 400 | Bei validate_repository: Der Body ist kein JSON-Objekt; repository_url fehlt, ist länger als 2.048 Zeichen, enthält Zugangsdaten oder hat nicht die Form https://github.com/{owner}/{repo} (ein .git-Suffix wird akzeptiert; ein anderer Host, ein längerer Pfad wie /tree/main einer Branch-Seite oder ein anderer Port als 443 oder 80 nicht); ref ist leer, ist länger als 255 Zeichen, enthält .. oder enthält ein anderes Zeichen als ASCII-Buchstaben, Ziffern, ., _, -, + und /; oder ein anderes Feld ist vorhanden. Ein ref, das diese Prüfungen besteht, aber einen Branch benennt, den das Repository nicht hat, wird nicht abgelehnt: Die Anfrage ist mit valid: false erfolgreich, und manifest_error gibt an, dass der Branch nicht gefunden wurde. Bei validate_archive: Der Body ist nicht multipart/form-data, der Teil archive fehlt, ist wiederholt oder wurde nicht als Dateiteil mit einem Dateinamen gesendet, oder ein anderes Formularfeld ist vorhanden. | Korrigiere die Anfrage und sende sie erneut. |
| 413 | Bei validate_archive: Der Teil archive oder die deklarierte Body-Länge der Anfrage überschreitet 32 MB. | Validiere stattdessen das Repository per URL oder verkleinere das Archiv. |
Berichtscodes
Jeder Befund in einem Bericht hat einen stabilen Code: manifest_error_code, wenn nichts validiert werden konnte, error_code bei jedem plugin_errors-Eintrag und error_code bei jeder Warnung. Wenn ein Plugin mehrere Probleme hat, ist error_code der Code des ersten, und error fügt ihre Meldungen zusammen. Neue Codes können hinzugefügt werden; ein unbekannter manifest_error_code bedeutet weiterhin, dass der Inhalt nicht validiert werden konnte, einer bei einem plugin_errors-Eintrag bedeutet weiterhin, dass das Plugin übersprungen würde, und einer bei einer Warnung bedeutet weiterhin, dass das Plugin synchronisiert würde. Diese Codes zeigen vorübergehende Zustände an, sodass dieselbe Anfrage später erfolgreich sein könnte: marketplace_host_rate_limited, marketplace_host_server_error, marketplace_host_timeout, marketplace_host_unreachable, marketplace_repo_access_denied, marketplace_sync_transient_fetch_budget_exhausted, marketplace_validate_network_error und normalerweise marketplace_validate_deadline_exceeded.
Unbekannte Werte
Jeder String-Wert auf dieser Seite (Komponententypen, reach, Scan-Felder, Marketplace-source, Fehlercodes) kann jederzeit neue Werte erhalten. Behandle einen Wert, den du nicht kennst, wie jeden anderen unbekannten String, statt einen Fehler auszulösen.
Ratenlimits
Leseanfragen (jeder GET-Endpunkt auf dieser Seite) teilen sich ein Limit von 300 Anfragen pro Minute für jede Organisation. Schreibanfragen (Erstellen eines Plugins oder einer Version, Ändern der bereitgestellten Version, Löschen, Setzen oder Entfernen einer Installationseinstellung und Aktualisieren eines Marketplace) teilen sich ein Limit von 60 Anfragen pro Minute für jede Organisation. Eine Marketplace-Validierung (beide Endpunkte) zählt als Lesevorgang, und Validierungen sind zusätzlich auf 10 pro Minute für jede Organisation über beide Endpunkte hinweg begrenzt; beide Limits werden geprüft, bevor der Request-Body gelesen wird. Diese Limits werden über alle Keys deiner Organisation hinweg gezählt und sind von den anderen Admin API-Limits deiner Organisation getrennt. Ein Lesevorgang, der organization_id übergibt, wird auf das Limit der Organisation angerechnet, in der der Key erstellt wurde, oder auf das der übergeordneten Organisation, wenn der Key keine eigene Organisation hat. Anfragen über einem Limit geben 429 Too Many Requests mit einem retry-after-Header zurück. Antworten enthalten anthropic-ratelimit-requests-*-Header für das jeweils geltende Limit (bei der Marketplace-Validierung ihr Limit von 10 pro Minute; bei einem 429 das Limit, das die Anfrage abgelehnt hat).
Ein Upload, eine Änderung der bereitgestellten Version oder eine Validierung kann außerdem 429 mit retry-after zurückgeben, wenn der Dienst kurzzeitig keine Kapazität für einen weiteren Vorgang hat, und ein Upload gibt 429 zurück, wenn deine Organisation ihre Rate für die Inhaltsprüfung überschritten hat. Behandle all diese Fälle gleich: Warte die in retry-after angegebene Zeit ab und versuche es dann erneut. Unabhängig von diesen Limits solltest du Schreibvorgänge für Installationseinstellungen desselben Plugins einzeln nacheinander senden: Treffen mehrere gleichzeitig ein, können einige mit 503 und x-should-retry: true beantwortet werden, und diese können nach ein bis zwei Sekunden gefahrlos erneut gesendet werden (siehe Installationseinstellung festlegen).
Paginierung
Listen-Endpunkte verwenden einen opaken Cursor. Die erste Anfrage gibt bis zu limit Zeilen sowie einen next_page-Cursor zurück; übergib den Cursor unverändert als page-Parameter bei der nächsten Anfrage und wiederhole dies, bis next_page null ist. Behandle den Cursor-String als opak: Parse, verändere oder konstruiere ihn nicht selbst. Plugins auflisten kann eine Seite mit weniger als limit Plugins oder gar keinen zurückgeben, während next_page noch gesetzt ist. Fordere daher weiter Seiten an, bis next_page null ist. Die Listen-Iteratoren der Python-, TypeScript-, C#-, Go-, Java- und Ruby-SDKs sowie die CLI (außer mit --format raw) erledigen das für dich. Sie fordern die nächste Seite an, solange next_page gesetzt ist, sodass eine kurze oder leere Seite sie nicht beendet. In PHP und curl forderst du jede Seite selbst an und übergibst ihr next_page als page.
limit ist standardmäßig 20 und hat ein Minimum von 1. Das Maximum beträgt 100 für Plugins, Installationseinstellungen und Freigaben sowie 1.000 für Versionen und Marketplaces. Jede Liste ist mit den neuesten Einträgen zuerst sortiert.
Fehlerantworten
Fehlerantworten folgen der Standardform, die in Claude API-Fehler dokumentiert ist. Gib die request_id aus dem Antwort-Body an, wenn du den Support kontaktierst.
| Status | Bedeutung |
|---|---|
| 400 | Ungültige Eingabe, oder der Vorgang gilt nicht für dieses Plugin oder diesen Marketplace (siehe den Abschnitt des jeweiligen Endpunkts). Wird auch für einen Query-Parameter zurückgegeben, den der Endpunkt nicht erkennt, sowie für eine Organisation, die keine Claude Enterprise-Organisation ist (this endpoint is not supported for this organization type). |
| 401 | Der Header x-api-key fehlt, oder der Key wird nicht erkannt. |
| 403 | Dem Key fehlt der erforderliche Scope, oder die Anfrage lädt in das Plugin oder den persönlichen Marketplace eines Mitglieds hoch, ändert dessen bereitgestellte Version oder legt dessen Standard fest. (Das Löschen des Plugins eines Mitglieds ist erlaubt.) |
| 404 | Ressource nicht gefunden. Wird auch zurückgegeben, wenn in der Anfrage der anthropic-beta-Wert fehlt oder die API für deine Organisation nicht aktiviert ist, sodass die Endpunkte als nicht existent erscheinen. |
| 409 | Ein Name ist vergeben, der content_scan einer Version lautet processing, oder ein konkurrierender Upload ist im Gange. |
| 413 | Der Anfragetext überschreitet die Größenbeschränkung: 200 MB für einen Upload, 32 MB für die Marketplace-Validierung. |
| 429 | „Rate limit“ (Ratenlimit) überschritten. Siehe Ratenlimits. |
| 500 | Interner Fehler. |
| 503 | Vorübergehend. Wird auch zurückgegeben, wenn mehrere Schreibvorgänge für Installationseinstellungen eines Plugins gleichzeitig eintreffen; sende diese nacheinander. Wiederhole die Anfrage mit „backoff“ (schrittweise verlängerter Wartezeit), außer bei registration_pending (siehe die folgende Tabelle). |
Wenn ein Status mehrere Ursachen hat, die du unterschiedlich behandeln würdest, enthält der Fehler zusätzlich error.details.error_code sowie error.details.plugin_id oder error.details.plugin_version_id, wenn die Ursache eines davon betrifft:
{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "...",
"details": {
"error_code": "plugin_name_taken",
"plugin_id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL"
}
},
"request_id": "req_018EeWyXxfu5pfWkrYcMdjWG"
}error_code | Status | Bedeutung und Vorgehen |
|---|---|---|
plugin_name_taken | 409 | Der Marketplace enthält diesen Namen bereits. details.plugin_id ist das Plugin, das ihn belegt, und möglicherweise hat es jemand anderes erstellt. Um herauszufinden, wer, rufe das Plugin ab und lies sein created_by, das null ist, wenn kein Ersteller erfasst ist. Lade nur dann Versionen dorthin hoch, wenn es das Plugin ist, das du aktualisieren wolltest. Andernfalls oder wenn plugin_id fehlt, lade unter einem anderen Namen hoch. |
skill_name_taken | 409 | Das Plugin befindet sich im Bibliotheks-Marketplace, und einer seiner Skills hat denselben Namen wie ein Organisations-Skill (ein Skill, den ein Administrator in claude.ai für die gesamte Organisation hochgeladen hat). details.skill_name nennt ihn. Benenne einen der beiden um oder entferne ihn. |
registration_pending | 503 | Die Dateien wurden gespeichert, aber die Skills des Plugins konnten den Mitgliedern noch nicht zur Verfügung gestellt werden. Siehe Uploads wiederholen. |
scan_pending | 409 | Der content_scan der Version lautet processing. Versuche es erneut, sobald der Scan abgeschlossen ist. |
scan_failed | 400 | Der content_scan der Version lautet fail, unknown oder errored, daher kann sie nicht bereitgestellt werden. Wähle eine andere Version. |
cmek_key_disabled, cmek_key_network_blocked | 400 | Der kundenverwaltete Verschlüsselungsschlüssel deiner Organisation ist nicht verfügbar. Siehe Kundenverwaltete Verschlüsselungsschlüssel. |
unsupported_charset | 400 | Bei einem Upload oder validate_archive benennt der Content-Type-Header der Anfrage einen anderen Zeichensatz als UTF-8, ISO-8859-1 oder US-ASCII. Sende die Anfrage ohne Zeichensatz oder mit einem dieser Zeichensätze. |
Es können neue Codes hinzukommen. Behandle einen Code, den du nicht kennst, so wie seinen Status.
Uploads wiederholen
Kein Endpunkt akzeptiert einen Idempotency-Key. Das Ändern der bereitgestellten Version, das Setzen einer Installationseinstellung und das Setzen eines Marketplace-Standards können gefahrlos wiederholt werden. Ein wiederholtes Löschen oder ein wiederholtes Entfernen einer Installationseinstellung gibt 404 zurück.
Ein Upload, der einen Fehler zurückgibt, hat nichts gespeichert, mit einer Ausnahme: 503 mit error_code: "registration_pending". Nach dem Speichern der Dateien eines Uploads registriert der Server die Skills der neuen Version bei claude.ai, wodurch sie für Mitglieder nutzbar werden; registration_pending bedeutet, dass die Dateien gespeichert wurden, dieser letzte Schritt aber nicht abgeschlossen wurde. Ein erneuter Upload derselben Dateien schließt ihn ab (und speichert eine weitere, identische Version):
- Bei
POST /v1/organizations/pluginswurde das Plugin erstellt, und die Antwort enthältx-should-retry: false: Sende die Erstellung nicht erneut (ein erneutes Senden gibt409 plugin_name_takenzurück); lade stattdessen dieselben Dateien als Version vondetails.plugin_idhoch. - Bei
POST /v1/organizations/plugins/{plugin_id}/versionswurde die Version gespeichert (details.plugin_version_id); sende dieselbe Anfrage erneut, wenn die Antwortx-should-retry: trueenthält, und nicht, wenn siefalseenthält.
Wenn die Antwort einer Erstellung verloren geht, sende die Erstellung erneut. Ein 409 plugin_name_taken bedeutet entweder, dass der erste Versuch das Plugin gespeichert hat, oder dass der Name bereits vergeben war. Deine verloren gegangene Erstellung hat das Plugin in details.plugin_id nur dann angelegt, wenn dessen created_by ein api_actor mit der api_key_id deines Keys ist. Prüfe das, bevor du dorthin hochlädst (siehe plugin_name_taken in der vorherigen Tabelle). Das Wiederholen einer Versionserstellung, deren Antwort verloren gegangen ist, speichert eine zweite, identische Version. Um das zu vermeiden, notiere vor jedem Upload die latest_version_id des Plugins; wenn eine Antwort verloren geht, lies das Plugin aus und wiederhole die Anfrage nur, wenn latest_version_id unverändert ist.
Activity Feed-Ereignisse
Jeder Schreibvorgang über diese API wird im Compliance API Activity Feed deiner Organisation erfasst und dem API-Key als api_actor mit dessen apikey_-ID zugeordnet. Derselbe Akteur erscheint in created_by bei den Plugins und Versionen, die der Key erstellt.
| Ereignis | Ausgelöst, wenn |
|---|---|
claude_plugin_created | Ein Plugin durch einen Upload (hier oder in claude.ai) oder durch eine angenommene Veröffentlichungsanfrage erstellt wird. Ein durch eine Git-Synchronisierung erstelltes Plugin löst nur claude_plugin_version_created aus. |
claude_plugin_version_created | Eine Version gespeichert wird. Durch eine Git-Synchronisierung gespeicherte Versionen werden einem system_actor zugeordnet. |
claude_plugin_updated | Eine neue Version in ein bestehendes Plugin hochgeladen wird. |
claude_plugin_served_version_updated | Sich die bereitgestellte Version ändert. |
claude_plugin_deleted | Ein Plugin einzeln gelöscht wird, hier oder in claude.ai. |
plugin_installation_preference_updated | Eine Installationseinstellung festgelegt oder entfernt wird. |
marketplace_created | Der erste Upload den Bibliotheks-Marketplace erstellt. |
marketplace_updated | Sich die Standard-Installationseinstellung eines Marketplace ändert oder ein Administrator oder Inhaber in claude.ai eine Synchronisierung startet. |
marketplace_deleted | Ein Marketplace zusammen mit seinen Plugins in claude.ai gelöscht wird (keine Ereignisse pro Plugin). |
claude_plugin_archive_accessed | Das Archiv eines Plugins, das einem Mitglied gehört, heruntergeladen wird. |
claude_plugin_security_scan_completed | Ein Content-Scan abgeschlossen wird. |
Die Plugin-, Versions- und Marketplace-IDs in diesen Ereignissen sind dieselben IDs, die diese API zurückgibt. Ein Ereignis kann auch einen Marketplace nennen, den diese API nicht auflistet, etwa einen Marketplace mit Plugins, die Anthropic veröffentlicht. plugin_installation_preference_updated identifiziert das Plugin anhand seines name und seiner marketplace_id statt seiner id. In claude_plugin_security_scan_completed ist plugin_version keine Versions-ID, und kein Feld einer Plugin-Version entspricht ihr.
Das Ändern des Standards eines Marketplace erfasst ein einzelnes marketplace_updated-Ereignis und keine Ereignisse pro Plugin, obwohl es den Wert jedes Plugins ändert, das den Standard erbt. Lesevorgänge werden nicht erfasst, mit Ausnahme von Downloads des Archivs eines Plugins, das einem Mitglied gehört. Ein Schreibvorgang, der nichts ändert, erfasst nichts.
In claude.ai erteilte oder entzogene Freigaben erscheinen im Feed als role_assignment_granted- und role_assignment_revoked-Ereignisse. Diese API meldet keine Löschungen: Ein gelöschtes Plugin fehlt in der nächsten Liste. Ein Plugin, das durch eine Git-Synchronisierung, durch das Löschen seines Marketplace (ein einzelnes marketplace_deleted-Ereignis) oder durch das Löschen des Kontos eines Mitglieds oder der Organisation entfernt wird, löst kein Ereignis pro Plugin aus. Rufe daher regelmäßig den vollständigen Bestand erneut ab, um Entfernungen zu erkennen.
Kundenverwaltete Verschlüsselungsschlüssel
Wenn deine Organisation einen „customer-managed encryption key“ (kundenverwalteten Verschlüsselungsschlüssel) verwendet, werden description, release_notes, components und die Dateien einer Version damit verschlüsselt. Solange der Schlüssel nicht verfügbar ist:
- Lese- und Listenvorgänge sind weiterhin erfolgreich, wobei
description,release_notesundcomponentsalsnullzurückgegeben werden. - Archiv-Downloads, Erstellungen, Versionserstellungen und Änderungen der bereitgestellten Version geben
400mitcmek_key_disabledodercmek_key_network_blockedzurück. - Das Löschen eines Plugins im Bibliotheks-Marketplace gibt
400 cmek_key_disabledzurück und löscht nichts, da seine Skills zuerst aus claude.ai zurückgezogen werden müssen und dafür der Schlüssel benötigt wird. Andere Löschvorgänge, Installationseinstellungen und Marketplace-Standards funktionieren normal.
Die Wiederherstellung des Schlüssels hebt all diese Einschränkungen auf.
Siehe auch
Wo dein primärer Inhaber einen Key mit eingeschränktem Scope erstellt.
Die Gruppen-Endpunkte, die die in Installationseinstellungen verwendeten rbac_group_-IDs liefern.
Wo Plugin-Schreibvorgänge und Downloads von Mitglieder-Archiven erfasst werden.
Berichte zur Plugin- und Skill-Nutzung für Claude Enterprise.
War diese Seite hilfreich?