Claude Platform Docs

Plugin

Crea plugin
client.beta.organization.plugins.create(params, options?): BetaPlugin
POST/v1/organizations/plugins

Crea un plugin di proprietà dell'organizzazione e la sua prima versione caricando i file della versione.

Ottieni plugin
client.beta.organization.plugins.retrieve(pluginID, params?, options?): BetaPlugin
GET/v1/organizations/plugins/{plugin_id}

Recupera un plugin tramite ID.

Aggiorna plugin
client.beta.organization.plugins.update(pluginID, params, options?): BetaPlugin
POST/v1/organizations/plugins/{plugin_id}

Cambia quale versione archiviata di un Plugin di proprietà dell'organizzazione viene servita ai membri, ad esempio per tornare a una versione precedente. Questa operazione fissa la versione servita: i caricamenti successivi vengono archiviati ma non cambiano più ciò che viene servito, e al momento il fissaggio non può essere annullato, né qui né in claude.ai.

Elenca i Plugin
client.beta.organization.plugins.list(params?, options?): PageCursor<BetaPlugin>
GET/v1/organizations/plugins

Elenca i Plugin creati nell'organizzazione, dal più recente: quelli nei marketplace di plugin dell'organizzazione e quelli nei marketplace di plugin personali dei membri.

Elimina Plugin
client.beta.organization.plugins.delete(pluginID, params?, options?): BetaDeletedPlugin
DELETE/v1/organizations/plugins/{plugin_id}

Elimina definitivamente un Plugin e tutte le sue versioni, esattamente come quando un amministratore lo elimina in claude.ai. Il Plugin può appartenere all'organizzazione o a un membro, incluso un membro che nel frattempo ha lasciato l'organizzazione.

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.

PluginVersioni

Crea versione del Plugin
client.beta.organization.plugins.versions.create(pluginID, params, options?): BetaPluginVersion
POST/v1/organizations/plugins/{plugin_id}/versions

Aggiungi una versione a un Plugin di proprietà dell'organizzazione caricando i file della nuova versione; diventa la versione servita ai membri a meno che la versione servita del Plugin non sia stata fissata.

Elenca le versioni del Plugin
client.beta.organization.plugins.versions.list(pluginID, params?, options?): PageCursor<BetaPluginVersion>
GET/v1/organizations/plugins/{plugin_id}/versions

Elenca le versioni di un Plugin, dalla più recente.

Ottieni versione del Plugin
client.beta.organization.plugins.versions.retrieve(version, params, options?): BetaPluginVersion
GET/v1/organizations/plugins/{plugin_id}/versions/{version}

Recupera una versione di un Plugin tramite il suo ID, oppure la versione più recente del Plugin.

Scarica l'archivio della versione del Plugin
client.beta.organization.plugins.versions.download(version, params, options?): Response
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content

Scarica l'archivio .zip di una versione, esattamente come è archiviato. Ogni download di un Plugin dal marketplace di plugin personale di un membro viene registrato nel feed delle attività della Compliance API.

PluginImpostazioni di installazione

Elenca le impostazioni di installazione del Plugin
client.beta.organization.plugins.installationSettings.list(pluginID, params?, options?): PageCursor<BetaPluginInstallationSetting>
GET/v1/organizations/plugins/{plugin_id}/installation_settings

Elenca le impostazioni di installazione di un Plugin di proprietà dell'organizzazione, che indicano a quali membri è destinato, dalla creata più di recente.

Imposta l'impostazione di installazione del Plugin
client.beta.organization.plugins.installationSettings.set(target, params, options?): BetaPluginInstallationSetting
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

Imposta o modifica l'impostazione di installazione di un Plugin di proprietà dell'organizzazione per l'intera organizzazione o per un gruppo RBAC.

Rimuovi l'impostazione di installazione del Plugin
client.beta.organization.plugins.installationSettings.remove(target, params, options?): BetaDeletedPluginInstallationSetting
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

Rimuovi l'impostazione di installazione propria di un Plugin di proprietà dell'organizzazione per l'intera organizzazione o per un gruppo RBAC.

PluginCondivisioni

Elenca le condivisioni del Plugin
client.beta.organization.plugins.shares.list(pluginID, params?, options?): PageCursor<BetaPluginShare>
GET/v1/organizations/plugins/{plugin_id}/shares

Elenca le condivisioni concesse dal proprietario di un Plugin di proprietà di un membro — a tutti i membri dell'organizzazione, a un gruppo RBAC o a un singolo membro — dalla concessa più di recente.