Claude Platform Docs

Plugins

Crear plugin
beta.organization.plugins.create(**kwargs) -> 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
beta.organization.plugins.retrieve(plugin_id, **kwargs) -> BetaPlugin
GET/v1/organizations/plugins/{plugin_id}

Recupera un plugin por ID.

Actualizar plugin
beta.organization.plugins.update(plugin_id, **kwargs) -> 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
beta.organization.plugins.list(**kwargs) -> 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
beta.organization.plugins.delete(plugin_id, **kwargs) -> 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
class BetaDeletedPlugin { type: :plugin_deleted, id }
type: :plugin_deleted

Always plugin_deleted.

id: String

The deleted Plugin's ID.

class BetaPlugin { type: :plugin, id, components, 16 more }
class 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.

api_key_id: String

The key's ID.

class 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

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.

class BetaPluginContentScan { assessment, reason, status }
assessment: :fail | :pass | :unknown | :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 | :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: :organization

The Plugin lives in a plugin marketplace the organization owns.

class BetaPluginOwnerUser { type: :user, user_id }
type: :user

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

user_id: String

The member's User ID.

class BetaPluginTargetOrganization { type: :organization }
type: :organization

Every member of the organization.

class BetaPluginTargetOrganizationMember { type: :organization_member, user_id }
type: :organization_member

One member of the organization.

user_id: String

The member's User ID.

class BetaPluginTargetRBACGroup { type: :rbac_group, rbac_group_id }
type: :rbac_group

An RBAC Group.

rbac_group_id: String

The RBAC Group's ID.

class BetaPluginUserActor { 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.

PluginsVersiones

Crear versión de Plugin
beta.organization.plugins.versions.create(plugin_id, **kwargs) -> 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
beta.organization.plugins.versions.list(plugin_id, **kwargs) -> 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
beta.organization.plugins.versions.retrieve(version, **kwargs) -> 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
beta.organization.plugins.versions.download(version, **kwargs) -> StringIO
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
beta.organization.plugins.installation_settings.list(plugin_id, **kwargs) -> 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
beta.organization.plugins.installation_settings.set(target, **kwargs) -> 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
beta.organization.plugins.installation_settings.remove(target, **kwargs) -> 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
beta.organization.plugins.shares.list(plugin_id, **kwargs) -> 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.