Claude Platform Docs

Plugin

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

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

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

Recupera un plugin tramite ID.

Aggiorna plugin
beta.organization.plugins.update(plugin_id, **kwargs) -> 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
beta.organization.plugins.list(**kwargs) -> SyncPageCursor[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
beta.organization.plugins.delete(plugin_id, **kwargs) -> 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
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.

PluginVersioni

Crea versione del Plugin
beta.organization.plugins.versions.create(plugin_id, **kwargs) -> 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
beta.organization.plugins.versions.list(plugin_id, **kwargs) -> SyncPageCursor[BetaPluginVersion]
GET/v1/organizations/plugins/{plugin_id}/versions

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

Ottieni versione del Plugin
beta.organization.plugins.versions.retrieve(version, **kwargs) -> 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
beta.organization.plugins.versions.download(version, **kwargs) -> BinaryResponseContent
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
beta.organization.plugins.installation_settings.list(plugin_id, **kwargs) -> SyncPageCursor[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
beta.organization.plugins.installation_settings.set(target, **kwargs) -> 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
beta.organization.plugins.installation_settings.remove(target, **kwargs) -> 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
beta.organization.plugins.shares.list(plugin_id, **kwargs) -> SyncPageCursor[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.