Claude Platform Docs

Plugins

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

Récupère un plugin par son ID.

Mettre à jour un plugin
beta.organization.plugins.update(plugin_id, **kwargs) -> 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
beta.organization.plugins.list(**kwargs) -> 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
beta.organization.plugins.delete(plugin_id, **kwargs) -> 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
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.

PluginsVersions

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