Claude Platform Docs

Plugins

Plugin erstellen
client.beta.organization.plugins.create(params, options?): 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
client.beta.organization.plugins.retrieve(pluginID, params?, options?): BetaPlugin
GET/v1/organizations/plugins/{plugin_id}

Ruft ein Plugin anhand seiner ID ab.

Plugin aktualisieren
client.beta.organization.plugins.update(pluginID, params, options?): 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
client.beta.organization.plugins.list(params?, options?): PageCursor<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
client.beta.organization.plugins.delete(pluginID, params?, options?): 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
interface BetaDeletedPlugin { type: "plugin_deleted"; id }
type: "plugin_deleted"

Always plugin_deleted.

defaultplugin_deleted
id: string

The deleted Plugin's ID.

interface BetaPlugin { type: "plugin"; id; components; /* 16 more */ }
interface BetaPluginAPIActor { type: "api_actor"; api_key_id }
type: "api_actor"

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

defaultapi_actor
api_key_id: string

The key's ID.

interface BetaPluginComponent { type; description; name }
type: "agent" | "cli" | "command" | 3 more

The kind of component.

One of the following:
"agent"
"cli"
"command"
"hook"
"mcp_server"
"skill"
description: string | null

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

name: string

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.

interface BetaPluginContentScan { assessment; reason; status }
assessment: "fail" | "pass" | "unknown" | "warn" | null

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

One of the following:
"fail"
"pass"
"unknown"
"warn"
reason: string | null

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: "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"
interface BetaPluginOwnerOrganization { type: "organization" }
type: "organization"

The Plugin lives in a plugin marketplace the organization owns.

defaultorganization
interface BetaPluginOwnerUser { type: "user"; user_id }
type: "user"

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

defaultuser
user_id: string

The member's User ID.

interface BetaPluginTargetOrganization { type: "organization" }
type: "organization"

Every member of the organization.

defaultorganization
interface BetaPluginTargetOrganizationMember { type: "organization_member"; user_id }
type: "organization_member"

One member of the organization.

defaultorganization_member
user_id: string

The member's User ID.

interface BetaPluginTargetRBACGroup { type: "rbac_group"; rbac_group_id }
type: "rbac_group"

An RBAC Group.

defaultrbac_group
rbac_group_id: string

The RBAC Group's ID.

interface BetaPluginUserActor { type: "user_actor"; email_address; user_id }
type: "user_actor"

A member of the organization.

defaultuser_actor
email_address: string | null

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

user_id: string

The member's User ID.

PluginsVersionen

Plugin-Version erstellen
client.beta.organization.plugins.versions.create(pluginID, params, options?): 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
client.beta.organization.plugins.versions.list(pluginID, params?, options?): PageCursor<BetaPluginVersion>
GET/v1/organizations/plugins/{plugin_id}/versions

Listet die Versionen eines Plugins auf, die neuesten zuerst.

Plugin-Version abrufen
client.beta.organization.plugins.versions.retrieve(version, params, options?): 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
client.beta.organization.plugins.versions.download(version, params, options?): Response
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
client.beta.organization.plugins.installationSettings.list(pluginID, params?, options?): PageCursor<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
client.beta.organization.plugins.installationSettings.set(target, params, options?): 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
client.beta.organization.plugins.installationSettings.remove(target, params, options?): 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
client.beta.organization.plugins.shares.list(pluginID, params?, options?): PageCursor<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.