Claude Platform Docs

Plugins

Create Plugin
client.Beta.Organization.Plugins.New(ctx, params) (*BetaPlugin, error)
POST/v1/organizations/plugins
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Create an organization-owned Plugin and its first version by uploading the version's files.

Get Plugin
client.Beta.Organization.Plugins.Get(ctx, pluginID, params) (*BetaPlugin, error)
GET/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Retrieve a Plugin by ID.

Update Plugin
client.Beta.Organization.Plugins.Update(ctx, pluginID, params) (*BetaPlugin, error)
POST/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Change which stored version of an organization-owned Plugin is served to members, for example to roll back to an earlier one. This pins the served version: later uploads are stored but no longer change what is served, and pinning cannot currently be undone, here or in claude.ai.

List Plugins
client.Beta.Organization.Plugins.List(ctx, params) (*PageCursor[BetaPlugin], error)
GET/v1/organizations/plugins
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

List the Plugins created under the organization, newest first: those in the organization's own plugin marketplaces and those in members' personal plugin marketplaces.

Delete Plugin
client.Beta.Organization.Plugins.Delete(ctx, pluginID, body) (*BetaDeletedPlugin, error)
DELETE/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Permanently delete a Plugin and every version it holds, exactly as when an administrator deletes it in claude.ai. The Plugin may belong to the organization or to a member, including a member who has since left the organization. Do not delete a Plugin only because your pipeline did not create it: a member or an administrator might have added it in claude.ai.

Models
type BetaDeletedPlugin struct { Type: "plugin_deleted"; ID }
Type PluginDeleted

Always plugin_deleted.

defaultplugin_deleted
ID string

The deleted Plugin's ID.

type BetaPlugin struct { Type: "plugin"; ID; Components; /* 16 more */ }
type BetaPluginAPIActor struct { Type: "api_actor"; APIKeyID }
Type APIActor

An Admin API key, in the same form the Compliance API activity feed uses for it.

defaultapi_actor
APIKeyID string

The key's ID.

type BetaPluginComponent struct { Type; Description; Name }
Type BetaPluginComponentType

The kind of component.

One of the following:
const BetaPluginComponentTypeAgent BetaPluginComponentType = "agent"
const BetaPluginComponentTypeCli BetaPluginComponentType = "cli"
const BetaPluginComponentTypeCommand BetaPluginComponentType = "command"
const BetaPluginComponentTypeHook BetaPluginComponentType = "hook"
const BetaPluginComponentTypeMCPServer BetaPluginComponentType = "mcp_server"
const BetaPluginComponentTypeSkill BetaPluginComponentType = "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.

type BetaPluginContentScan struct { Assessment; Reason; Status }
Assessment BetaPluginContentScanAssessment

The scan's verdict; set only when status is completed. A warn can mean a fail that was allowed in claude.ai.

One of the following:
const BetaPluginContentScanAssessmentFail BetaPluginContentScanAssessment = "fail"
const BetaPluginContentScanAssessmentPass BetaPluginContentScanAssessment = "pass"
const BetaPluginContentScanAssessmentUnknown BetaPluginContentScanAssessment = "unknown"
const BetaPluginContentScanAssessmentWarn BetaPluginContentScanAssessment = "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. Read status first: on an errored scan it is not a finding but why there is no verdict: scan-invalid-archive, the scan refused the version's archive, or could not process it, before checking what its files say, and running it again will not help, so change the files and store a new version; scan-did-not-finish, the scan did not finish or its result is no longer available, so retry the scan in claude.ai if it offers a retry; scan-unavailable, the scan could not run or its result cannot be read right now, so read the version again later, then retry the scan in claude.ai if it offers a retry. If these steps do not help, contact support. Null on a pass, while a scan runs, and when no mechanism is reported for the verdict. On an errored scan, null means that a compliance configuration ruled out the scan.

Status BetaPluginContentScanStatus

processing while a scan runs, completed when it ran to completion, errored when it could not run. Once a scan of the version has completed, content_scan describes the newest completed scan, even while a later scan runs. While the scan outcome cannot be read, status is errored instead.

One of the following:
const BetaPluginContentScanStatusCompleted BetaPluginContentScanStatus = "completed"
const BetaPluginContentScanStatusErrored BetaPluginContentScanStatus = "errored"
const BetaPluginContentScanStatusProcessing BetaPluginContentScanStatus = "processing"
type BetaPluginNameTakenErrorDetails struct { ErrorCode; PluginID }
ErrorCode BetaPluginNameTakenErrorCode
PluginID string Optional
type BetaPluginOwnerOrganization struct { Type: "organization" }
Type Organization

The Plugin lives in a plugin marketplace the organization owns.

defaultorganization
type BetaPluginOwnerUser struct { Type: "user"; UserID }
Type User

The Plugin lives in one member's personal plugin marketplace.

defaultuser
UserID string

The member's User ID.

type BetaPluginTargetOrganization struct { Type: "organization" }
Type Organization

Every member of the organization.

defaultorganization
type BetaPluginTargetOrganizationMember struct { Type: "organization_member"; UserID }
Type OrganizationMember

One member of the organization.

defaultorganization_member
UserID string

The member's User ID.

type BetaPluginTargetRBACGroup struct { Type: "rbac_group"; RBACGroupID }
Type RBACGroup

An RBAC Group.

defaultrbac_group
RBACGroupID string

The RBAC Group's ID.

type BetaPluginUserActor struct { Type: "user_actor"; EmailAddress; UserID }
Type UserActor

A member of the organization.

defaultuser_actor
EmailAddress string

The member's email address; may be null, for example when they are no longer a member of the organization.

UserID string

The member's User ID.

type BetaRegistrationPendingErrorDetails struct { ErrorCode; PluginID; PluginVersionID }
ErrorCode BetaRegistrationPendingErrorCode
PluginID string
PluginVersionID string
type BetaScanFailedErrorDetails struct { ErrorCode; PluginVersionID }
ErrorCode BetaScanFailedErrorCode
PluginVersionID string
type BetaScanPendingErrorDetails struct { ErrorCode; PluginVersionID }
ErrorCode BetaScanPendingErrorCode
PluginVersionID string
type BetaSkillNameTakenErrorDetails struct { ErrorCode; SkillName }
ErrorCode BetaSkillNameTakenErrorCode
SkillName string
Errors
const ErrorCodeBetaScanFailed ErrorCode = "scan_failed"⁠HTTP status 400

The version in plugin_version_id did not pass its content scan, so it cannot be served.

const ErrorCodeBetaPluginNameTaken ErrorCode = "plugin_name_taken"⁠HTTP status 409

The marketplace already holds this name. plugin_id is the Plugin that holds it, and can be absent.

const ErrorCodeBetaScanPending ErrorCode = "scan_pending"⁠HTTP status 409

The content scan of the version in plugin_version_id is still running. Retry once the scan finishes.

const ErrorCodeBetaSkillNameTaken ErrorCode = "skill_name_taken"⁠HTTP status 409

One of the Plugin's skills has the name of an organization skill. skill_name is that name.

const ErrorCodeBetaRegistrationPending ErrorCode = "registration_pending"⁠HTTP status 503

The Plugin version was stored but is not yet usable in claude.ai. plugin_id and plugin_version_id identify what was stored.

PluginsVersions

Create Plugin Version
client.Beta.Organization.Plugins.Versions.New(ctx, pluginID, params) (*BetaPluginVersion, error)
POST/v1/organizations/plugins/{plugin_id}/versions
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Add a version to an organization-owned Plugin by uploading the new version's files; it becomes the version served to members unless the Plugin's served version has been pinned.

List Plugin Versions
client.Beta.Organization.Plugins.Versions.List(ctx, pluginID, params) (*PageCursor[BetaPluginVersion], error)
GET/v1/organizations/plugins/{plugin_id}/versions
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

List a Plugin's versions, newest first.

Get Plugin Version
client.Beta.Organization.Plugins.Versions.Get(ctx, version, params) (*BetaPluginVersion, error)
GET/v1/organizations/plugins/{plugin_id}/versions/{version}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Retrieve one version of a Plugin by its ID, or the Plugin's newest version.

Download Plugin Version Archive
client.Beta.Organization.Plugins.Versions.Download(ctx, version, params) (*Response, error)
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Download one version's .zip archive, exactly as stored. Each download of a Plugin from a member's personal plugin marketplace is recorded on the Compliance API activity feed.

List Plugin Installation Settings
client.Beta.Organization.Plugins.InstallationSettings.List(ctx, pluginID, params) (*PageCursor[BetaPluginInstallationSetting], error)
GET/v1/organizations/plugins/{plugin_id}/installation_settings
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

List an organization-owned Plugin's installation settings, which say which members it is for, most recently created first.

Set Plugin Installation Setting
client.Beta.Organization.Plugins.InstallationSettings.Set(ctx, target, params) (*BetaPluginInstallationSetting, error)
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Set or change an organization-owned Plugin's installation setting for the whole organization or for one RBAC Group.

Remove Plugin Installation Setting
client.Beta.Organization.Plugins.InstallationSettings.Remove(ctx, target, params) (*BetaDeletedPluginInstallationSetting, error)
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Remove an organization-owned Plugin's own installation setting for the whole organization or for one RBAC Group.

PluginsShares

List Plugin Shares
client.Beta.Organization.Plugins.Shares.List(ctx, pluginID, params) (*PageCursor[BetaPluginShare], error)
GET/v1/organizations/plugins/{plugin_id}/shares
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

List the shares the owner of a member-owned Plugin has given — to every member of the organization, to an RBAC Group, or to one member — most recently granted first.