Claude Platform Docs

Plugins

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

Crea un plugin propiedad de la organización y su primera versión cargando los archivos de la versión.

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

Recupera un plugin por ID.

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

Cambia qué versión almacenada de un Plugin propiedad de la organización se sirve a los miembros, por ejemplo, para revertir a una anterior. Esto fija la versión servida: las cargas posteriores se almacenan, pero ya no cambian lo que se sirve, y actualmente la fijación no se puede deshacer, ni aquí ni en claude.ai.

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

Lista los Plugins creados en la organización, del más reciente al más antiguo: los de los marketplaces de plugins propios de la organización y los de los marketplaces de plugins personales de los miembros.

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

Elimina permanentemente un Plugin y todas las versiones que contiene, exactamente como cuando un administrador lo elimina en claude.ai. El Plugin puede pertenecer a la organización o a un miembro, incluido un miembro que ya haya dejado la organización.

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.

PluginsVersiones

Crear versión de Plugin
client.beta.organization.plugins.versions.create(pluginID, params, options?): BetaPluginVersion
POST/v1/organizations/plugins/{plugin_id}/versions

Agrega una versión a un Plugin propiedad de la organización cargando los archivos de la nueva versión; se convierte en la versión que se sirve a los miembros, a menos que la versión servida del Plugin se haya fijado.

Listar versiones de Plugin
client.beta.organization.plugins.versions.list(pluginID, params?, options?): PageCursor<BetaPluginVersion>
GET/v1/organizations/plugins/{plugin_id}/versions

Lista las versiones de un Plugin, de la más reciente a la más antigua.

Obtener versión de Plugin
client.beta.organization.plugins.versions.retrieve(version, params, options?): BetaPluginVersion
GET/v1/organizations/plugins/{plugin_id}/versions/{version}

Recupera una versión de un Plugin por su ID, o la versión más reciente del Plugin.

Descargar archivo de versión de Plugin
client.beta.organization.plugins.versions.download(version, params, options?): Response
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content

Descarga el archivo .zip de una versión, exactamente como está almacenado. Cada descarga de un Plugin del marketplace de plugins personal de un miembro se registra en el feed de actividad de la Compliance API.

PluginsConfiguración de instalación

Listar configuraciones de instalación de Plugin
client.beta.organization.plugins.installationSettings.list(pluginID, params?, options?): PageCursor<BetaPluginInstallationSetting>
GET/v1/organizations/plugins/{plugin_id}/installation_settings

Lista las configuraciones de instalación de un Plugin propiedad de la organización, que indican para qué miembros es, de la creada más recientemente a la más antigua.

Establecer configuración de instalación de Plugin
client.beta.organization.plugins.installationSettings.set(target, params, options?): BetaPluginInstallationSetting
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

Establece o cambia la configuración de instalación de un Plugin propiedad de la organización para toda la organización o para un grupo RBAC.

Eliminar configuración de instalación de Plugin
client.beta.organization.plugins.installationSettings.remove(target, params, options?): BetaDeletedPluginInstallationSetting
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

Elimina la configuración de instalación propia de un Plugin propiedad de la organización para toda la organización o para un grupo RBAC.

PluginsComparticiones

Listar comparticiones de Plugin
client.beta.organization.plugins.shares.list(pluginID, params?, options?): PageCursor<BetaPluginShare>
GET/v1/organizations/plugins/{plugin_id}/shares

Lista las comparticiones que ha otorgado el propietario de un Plugin propiedad de un miembro (a todos los miembros de la organización, a un grupo RBAC o a un miembro), de la otorgada más recientemente a la más antigua.