Plugin erstellen
Erstellt ein Plugin im Besitz der Organisation und seine erste Version, indem die Dateien der Version hochgeladen werden.
Der Upload erfolgt als multipart/form-data: die Dateien der Version (files, jeder Teil wird
als files[] gesendet), optional mit marketplace_id und release_notes. Der name des Manifests wird zum
name des Plugins, und display_name, description und manifest_version stammen
ebenfalls aus dem Manifest.
name darf Kleinbuchstaben (aus beliebigen Alphabeten), Ziffern und Bindestriche enthalten, bis
zu 64 Zeichen. Großbuchstaben, Leerzeichen, Unterstriche und andere Satzzeichen werden
abgelehnt.
Der name muss innerhalb des Marketplace eindeutig sein: Ein bereits vergebener Name
gibt einen 409 mit error_code plugin_name_taken zurück und, falls ein Plugin ihn belegt,
die ID dieses Plugins in details.plugin_id. Ein Plugin, das in den Bibliotheks-Marketplace der Organisation
aufgenommen werden soll, wird ebenfalls mit einem 409 abgelehnt, wenn einer seiner Skills den Namen
eines Organisations-Skills trägt (ein Skill, den ein Administrator für die gesamte Organisation
in claude.ai hochgeladen hat): error_code skill_name_taken, mit diesem Namen in
details.skill_name; benenne den Skill um oder entferne den Organisations-Skill in
claude.ai. Ein 503 mit error_code
registration_pending bedeutet, dass das Plugin und seine Version gespeichert wurden (ihre IDs stehen
in details), aber in claude.ai noch nicht nutzbar sind: Wiederhole die Erstellung nicht (der
erneute Versuch würde plugin_name_taken zurückgeben); erstelle stattdessen eine Version für das gespeicherte Plugin,
wodurch es vervollständigt wird.
Ein ausgearbeitetes Beispiel findest du unter Plugin erstellen im Plugins-API-Leitfaden.
Akzeptierte Anmeldedaten: ein Admin-API-Key mit dem Scope write:plugins.
Jede Anfrage muss den Beta-Header anthropic-beta: ce-plugins-2026-09-01 enthalten. Eine Anfrage ohne diesen Header gibt 404 zurück, genau so, als ob der Endpunkt nicht existieren würde. Die Plugins API befindet sich in der Beta und ist nur für Claude Enterprise-Organisationen verfügbar. Sie ist nicht für Claude Platform-Organisationen (Claude Console) oder für Organisationen mit aktivierter HIPAA-Readiness verfügbar.
Parameters
Returns
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ.get(
"ANTHROPIC_API_KEY"
), # This is the default and can be omitted
)
beta_plugin = client.beta.organization.plugins.create(
files=[b"Example data"],
)
print(beta_plugin.id){
"id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
"components": [
{
"description": "description",
"name": "review-pr",
"type": "skill"
}
],
"content_scan": {
"assessment": "warn",
"reason": "credential-exposure",
"status": "completed"
},
"created_at": "2026-03-14T09:26:53.589793Z",
"created_by": {
"email_address": "user@example.com",
"type": "user_actor",
"user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
},
"description": "Reviews pull requests against your team's conventions.",
"display_name": "Code Review Helper",
"latest_version_id": "pluginver_01KaZmQpRsTuVwXyZ2b4c6d8",
"manifest_version": "1.2.0",
"marketplace_id": "marketplace_01HxQ3v9KpZ2mTn8RwLc4Ys7",
"name": "code-review-helper",
"organization_installation_preference": "available",
"organization_installation_preference_inherited": true,
"owner": {
"type": "organization"
},
"reach": "contained",
"served_version_id": "pluginver_01K9wPcHd4Rm2Tx8Vq6Ln3Sb",
"served_version_pinned": true,
"type": "plugin",
"updated_at": "2026-03-14T09:26:53.589793Z"
}Returns Examples
{
"id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
"components": [
{
"description": "description",
"name": "review-pr",
"type": "skill"
}
],
"content_scan": {
"assessment": "warn",
"reason": "credential-exposure",
"status": "completed"
},
"created_at": "2026-03-14T09:26:53.589793Z",
"created_by": {
"email_address": "user@example.com",
"type": "user_actor",
"user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
},
"description": "Reviews pull requests against your team's conventions.",
"display_name": "Code Review Helper",
"latest_version_id": "pluginver_01KaZmQpRsTuVwXyZ2b4c6d8",
"manifest_version": "1.2.0",
"marketplace_id": "marketplace_01HxQ3v9KpZ2mTn8RwLc4Ys7",
"name": "code-review-helper",
"organization_installation_preference": "available",
"organization_installation_preference_inherited": true,
"owner": {
"type": "organization"
},
"reach": "contained",
"served_version_id": "pluginver_01K9wPcHd4Rm2Tx8Vq6Ln3Sb",
"served_version_pinned": true,
"type": "plugin",
"updated_at": "2026-03-14T09:26:53.589793Z"
}