Claude Platform Docs

Plugins

Plugin erstellen
beta.organization.plugins.create(**kwargs) -> BetaPlugin
POST/v1/organizations/plugins

Erstellt ein Plugin im Besitz der Organisation und seine erste Version, indem die Dateien der Version hochgeladen werden.

Plugin abrufen
beta.organization.plugins.retrieve(plugin_id, **kwargs) -> BetaPlugin
GET/v1/organizations/plugins/{plugin_id}

Ruft ein Plugin anhand seiner ID ab.

Plugin aktualisieren
beta.organization.plugins.update(plugin_id, **kwargs) -> BetaPlugin
POST/v1/organizations/plugins/{plugin_id}

Ändere, welche gespeicherte Version eines organisationseigenen Plugins an Mitglieder ausgeliefert wird, zum Beispiel um zu einer früheren zurückzukehren. Dadurch wird die ausgelieferte Version fixiert: Spätere Uploads werden gespeichert, ändern aber nicht mehr, was ausgeliefert wird, und die Fixierung kann derzeit nicht rückgängig gemacht werden, weder hier noch in claude.ai.

Plugins auflisten
beta.organization.plugins.list(**kwargs) -> SyncPageCursor[BetaPlugin]
GET/v1/organizations/plugins

Listet die unter der Organisation erstellten Plugins auf, die neuesten zuerst: diejenigen in den eigenen Plugin-Marketplaces der Organisation und diejenigen in den persönlichen Plugin-Marketplaces der Mitglieder.

Plugin löschen
beta.organization.plugins.delete(plugin_id, **kwargs) -> BetaDeletedPlugin
DELETE/v1/organizations/plugins/{plugin_id}

Löscht ein Plugin und jede seiner Versionen dauerhaft, genau so, als würde ein Administrator es in claude.ai löschen. Das Plugin kann der Organisation oder einem Mitglied gehören, auch einem Mitglied, das die Organisation inzwischen verlassen hat.

Models
class BetaDeletedPlugin: type: "plugin_deleted"; id
type: Literal["plugin_deleted"]

Always plugin_deleted.

defaultplugin_deleted
id: str

The deleted Plugin's ID.

class BetaPlugin: type: "plugin"; id; components; ... # 16 more
class BetaPluginAPIActor: type: "api_actor"; api_key_id
type: Literal["api_actor"]

An Admin API key, in the same form the Compliance API activity feed uses for it.

defaultapi_actor
api_key_id: str

The key's ID.

class BetaPluginComponent: type; description; name
type: Literal["agent", "cli", "command", 3 more]

The kind of component.

One of the following:
"agent"
"cli"
"command"
"hook"
"mcp_server"
"skill"
description: Optional[str]

What the component declares about itself; always null for MCP servers, hooks, and CLIs.

name: str

The component's name: a skill's, command's or agent's name, an MCP server's key in the manifest, the event a hook runs on, or a CLI's executable.

class BetaPluginContentScan: assessment; reason; status
assessment: Optional[Literal["fail", "pass", "unknown", "warn"]]

The scan's verdict; set only when status is completed.

One of the following:
"fail"
"pass"
"unknown"
"warn"
reason: Optional[str]

The primary mechanism behind a warn or fail, such as credential-exposure or guardrail-tampering; a mechanism this API does not yet name reads as other. Null on a pass, whenever assessment is null, and when no mechanism is reported for the verdict.

status: Literal["completed", "errored", "processing"]

processing while a scan runs, completed when it ran to completion, errored when it could not run or its outcome cannot be read.

One of the following:
"completed"
"errored"
"processing"
class BetaPluginOwnerOrganization: type: "organization"
type: Literal["organization"]

The Plugin lives in a plugin marketplace the organization owns.

defaultorganization
class BetaPluginOwnerUser: type: "user"; user_id
type: Literal["user"]

The Plugin lives in one member's personal plugin marketplace.

defaultuser
user_id: str

The member's User ID.

class BetaPluginTargetOrganization: type: "organization"
type: Literal["organization"]

Every member of the organization.

defaultorganization
class BetaPluginTargetOrganizationMember: type: "organization_member"; user_id
type: Literal["organization_member"]

One member of the organization.

defaultorganization_member
user_id: str

The member's User ID.

class BetaPluginTargetRBACGroup: type: "rbac_group"; rbac_group_id
type: Literal["rbac_group"]

An RBAC Group.

defaultrbac_group
rbac_group_id: str

The RBAC Group's ID.

class BetaPluginUserActor: type: "user_actor"; email_address; user_id
type: Literal["user_actor"]

A member of the organization.

defaultuser_actor
email_address: Optional[str]

The member's email address; may be null, for example when they are no longer a member of the organization.

user_id: str

The member's User ID.

PluginsVersionen

Plugin-Version erstellen
beta.organization.plugins.versions.create(plugin_id, **kwargs) -> BetaPluginVersion
POST/v1/organizations/plugins/{plugin_id}/versions

Fügt einem organisationseigenen Plugin eine Version hinzu, indem die Dateien der neuen Version hochgeladen werden; sie wird zur an Mitglieder ausgelieferten Version, sofern die ausgelieferte Version des Plugins nicht fixiert wurde.

Plugin-Versionen auflisten
beta.organization.plugins.versions.list(plugin_id, **kwargs) -> SyncPageCursor[BetaPluginVersion]
GET/v1/organizations/plugins/{plugin_id}/versions

Listet die Versionen eines Plugins auf, die neuesten zuerst.

Plugin-Version abrufen
beta.organization.plugins.versions.retrieve(version, **kwargs) -> BetaPluginVersion
GET/v1/organizations/plugins/{plugin_id}/versions/{version}

Ruft eine Version eines Plugins anhand ihrer ID oder die neueste Version des Plugins ab.

Archiv einer Plugin-Version herunterladen
beta.organization.plugins.versions.download(version, **kwargs) -> BinaryResponseContent
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content

Lädt das .zip-Archiv einer Version genau so herunter, wie es gespeichert ist. Jeder Download eines Plugins aus dem persönlichen Plugin-Marketplace eines Mitglieds wird im Aktivitäts-Feed der Compliance API protokolliert.

PluginsInstallationseinstellungen

Plugin-Installationseinstellungen auflisten
beta.organization.plugins.installation_settings.list(plugin_id, **kwargs) -> SyncPageCursor[BetaPluginInstallationSetting]
GET/v1/organizations/plugins/{plugin_id}/installation_settings

Listet die Installationseinstellungen eines organisationseigenen Plugins auf, die angeben, für welche Mitglieder es bestimmt ist, die zuletzt erstellten zuerst.

Plugin-Installationseinstellung festlegen
beta.organization.plugins.installation_settings.set(target, **kwargs) -> BetaPluginInstallationSetting
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

Legt die Installationseinstellung eines organisationseigenen Plugins für die gesamte Organisation oder für eine RBAC-Gruppe fest oder ändert sie.

Plugin-Installationseinstellung entfernen
beta.organization.plugins.installation_settings.remove(target, **kwargs) -> BetaDeletedPluginInstallationSetting
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

Entfernt die eigene Installationseinstellung eines organisationseigenen Plugins für die gesamte Organisation oder für eine RBAC-Gruppe.

PluginsFreigaben

Plugin-Freigaben auflisten
beta.organization.plugins.shares.list(plugin_id, **kwargs) -> SyncPageCursor[BetaPluginShare]
GET/v1/organizations/plugins/{plugin_id}/shares

Listet die Freigaben auf, die der Eigentümer eines mitgliedseigenen Plugins erteilt hat – für jedes Mitglied der Organisation, für eine RBAC-Gruppe oder für ein einzelnes Mitglied –, die zuletzt erteilten zuerst.