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) -> SyncPageCursor[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: 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.

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) -> SyncPageCursor[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) -> BinaryResponseContent
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) -> SyncPageCursor[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) -> SyncPageCursor[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.