Claude Platform Docs

Plugins

Créer un plugin
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
GET/v1/organizations/plugins/{plugin_id}

Récupère un plugin par son ID.

Mettre à jour un plugin
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
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
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
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.

PluginsVersions

Créer une version de Plugin
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
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
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
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
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
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
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
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.