Claude Platform Docs

Plugins

Créer un plugin
client.beta.organization.plugins.create(params, options?): BetaPlugin
POST/v1/organizations/plugins

Crée un plugin appartenant à l'organisation ainsi que sa première version en téléversant les fichiers de la version.

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

Récupère un plugin par son ID.

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

Modifiez la version stockée d'un Plugin appartenant à l'organisation qui est servie aux membres, par exemple pour revenir à une version antérieure. Cela épingle la version servie : les téléversements ultérieurs sont stockés mais ne modifient plus ce qui est servi, et l'épinglage ne peut actuellement pas être annulé, ni ici ni dans claude.ai.

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

Listez les Plugins créés au sein de l'organisation, du plus récent au plus ancien : ceux des marketplaces de plugins de l'organisation et ceux des marketplaces de plugins personnelles des membres.

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

Supprimez définitivement un Plugin et toutes ses versions, exactement comme lorsqu'un administrateur le supprime dans claude.ai. Le Plugin peut appartenir à l'organisation ou à un membre, y compris un membre qui a depuis quitté l'organisation.

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.

PluginsVersions

Créer une version de Plugin
client.beta.organization.plugins.versions.create(pluginID, params, options?): BetaPluginVersion
POST/v1/organizations/plugins/{plugin_id}/versions

Ajoutez une version à un Plugin appartenant à l'organisation en téléversant les fichiers de la nouvelle version ; elle devient la version servie aux membres, sauf si la version servie du Plugin a été épinglée.

Lister les versions d'un Plugin
client.beta.organization.plugins.versions.list(pluginID, params?, options?): PageCursor<BetaPluginVersion>
GET/v1/organizations/plugins/{plugin_id}/versions

Listez les versions d'un Plugin, de la plus récente à la plus ancienne.

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

Récupérez une version d'un Plugin par son ID, ou la version la plus récente du Plugin.

Télécharger l'archive d'une version de Plugin
client.beta.organization.plugins.versions.download(version, params, options?): Response
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content

Téléchargez l'archive .zip d'une version, exactement telle qu'elle est stockée. Chaque téléchargement d'un Plugin provenant de la marketplace de plugins personnelle d'un membre est enregistré dans le flux d'activité de l'API Compliance.

PluginsParamètres d'installation

Lister les paramètres d'installation d'un Plugin
client.beta.organization.plugins.installationSettings.list(pluginID, params?, options?): PageCursor<BetaPluginInstallationSetting>
GET/v1/organizations/plugins/{plugin_id}/installation_settings

Listez les paramètres d'installation d'un Plugin appartenant à l'organisation, qui indiquent à quels membres il est destiné, du plus récemment créé au plus ancien.

Définir un paramètre d'installation de Plugin
client.beta.organization.plugins.installationSettings.set(target, params, options?): BetaPluginInstallationSetting
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

Définissez ou modifiez le paramètre d'installation d'un Plugin appartenant à l'organisation pour l'ensemble de l'organisation ou pour un groupe RBAC.

Supprimer un paramètre d'installation de Plugin
client.beta.organization.plugins.installationSettings.remove(target, params, options?): BetaDeletedPluginInstallationSetting
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

Supprimez le paramètre d'installation propre à un Plugin appartenant à l'organisation pour l'ensemble de l'organisation ou pour un groupe RBAC.

PluginsPartages

Lister les partages d'un Plugin
client.beta.organization.plugins.shares.list(pluginID, params?, options?): PageCursor<BetaPluginShare>
GET/v1/organizations/plugins/{plugin_id}/shares

Listez les partages accordés par le propriétaire d'un Plugin appartenant à un membre — à tous les membres de l'organisation, à un groupe RBAC ou à un seul membre —, du plus récemment accordé au plus ancien.