Claude Platform Docs

Plugins

Crear plugin
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
GET/v1/organizations/plugins/{plugin_id}

Recupera un plugin por ID.

Actualizar plugin
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
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
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
BetaDeletedPlugin object{ type: "plugin_deleted", id }
type: "plugin_deleted"

Always plugin_deleted.

defaultplugin_deleted
id: string

The deleted Plugin's ID.

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

defaultapi_actor
api_key_id: string

The key's ID.

BetaPluginComponent 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 or 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.

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

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

One of the following:
"fail"
"pass"
"unknown"
"warn"
reason: string or 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" 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"
BetaPluginOwnerOrganization object{ type: "organization" }
type: "organization"

The Plugin lives in a plugin marketplace the organization owns.

defaultorganization
BetaPluginOwnerUser object{ 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.

BetaPluginTargetOrganization object{ type: "organization" }
type: "organization"

Every member of the organization.

defaultorganization
BetaPluginTargetOrganizationMember object{ type: "organization_member", user_id }
type: "organization_member"

One member of the organization.

defaultorganization_member
user_id: string

The member's User ID.

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

An RBAC Group.

defaultrbac_group
rbac_group_id: string

The RBAC Group's ID.

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

A member of the organization.

defaultuser_actor
email_address: string or 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
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
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
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
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
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
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
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
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.