Claude Platform Docs

Plugin

Crea plugin
$ ant beta:organization:plugins create
POST/v1/organizations/plugins

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

Ottieni plugin
$ ant beta:organization:plugins retrieve
GET/v1/organizations/plugins/{plugin_id}

Recupera un plugin tramite ID.

Aggiorna plugin
$ ant beta:organization:plugins update
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
$ ant beta:organization:plugins list
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
$ ant beta:organization:plugins delete
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
beta_deleted_plugin: object{ type: "plugin_deleted", id }
type: "plugin_deleted"

Always plugin_deleted.

id: string

The deleted Plugin's ID.

beta_plugin: object{ type: "plugin", id, components, 16 more }
beta_plugin_api_actor: object{ 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.

api_key_id: string

The key's ID.

beta_plugin_component: object{ type, description, name }
type: "agent" or "cli" or "command" or 3 more

The kind of component.

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

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.

beta_plugin_content_scan: object{ assessment, reason, status }
assessment: "fail" or "pass" or "unknown" or "warn"

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

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

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" or "errored" or "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"
beta_plugin_owner_organization: object{ type: "organization" }
type: "organization"

The Plugin lives in a plugin marketplace the organization owns.

beta_plugin_owner_user: object{ type: "user", user_id }
type: "user"

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

user_id: string

The member's User ID.

beta_plugin_target_organization: object{ type: "organization" }
type: "organization"

Every member of the organization.

beta_plugin_target_organization_member: object{ type: "organization_member", user_id }
type: "organization_member"

One member of the organization.

user_id: string

The member's User ID.

beta_plugin_target_rbac_group: object{ type: "rbac_group", rbac_group_id }
type: "rbac_group"

An RBAC Group.

rbac_group_id: string

The RBAC Group's ID.

beta_plugin_user_actor: object{ type: "user_actor", email_address, user_id }
type: "user_actor"

A member of the organization.

email_address: string

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
$ ant beta:organization:plugins:versions create
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
$ ant beta:organization:plugins:versions list
GET/v1/organizations/plugins/{plugin_id}/versions

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

Ottieni versione del Plugin
$ ant beta:organization:plugins:versions retrieve
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
$ ant beta:organization:plugins:versions download
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
$ ant beta:organization:plugins:installation-settings list
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
$ ant beta:organization:plugins:installation-settings set
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
$ ant beta:organization:plugins:installation-settings remove
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
$ ant beta:organization:plugins:shares list
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.