Claude Platform Docs

Обновление плагина

$ ant beta:organization:plugins update
POST/v1/organizations/plugins/{plugin_id}

Изменяет, какая из сохранённых версий плагина, принадлежащего организации, предоставляется участникам, — например, чтобы откатиться к более ранней. Это закрепляет предоставляемую версию: последующие загрузки сохраняются, но больше не меняют предоставляемую версию, а закрепление в настоящее время нельзя отменить ни здесь, ни в claude.ai.

Передайте версию в served_version_id: более раннюю — чтобы откатиться, более позднюю — чтобы начать предоставлять версию, которая была сохранена без предоставления, или уже предоставляемую — чтобы закрепить её, не меняя предоставляемую версию. Новая версия не создаётся.

Если в организации включено сканирование содержимого, версия, сканирование которой ещё выполняется, отклоняется с кодом 409 (error_code scan_pending; повторите попытку после завершения сканирования), а версия, сканирование которой завершилось неудачей, ошибкой или без вердикта, — с кодом 400 (scan_failed; результат warn принимается). Если плагин находится в библиотечном маркетплейсе организации, версия, отличная от предоставляемой, также отклоняется с кодом 409, если один из её навыков имеет имя, которое с тех пор занял навык организации (навык, загруженный администратором для всей организации в claude.ai): error_code skill_name_taken, а это имя указывается в details.skill_name. Плагин, принадлежащий участнику, здесь обновить нельзя (403).

Эта конечная точка не записывает параметры установки; они записываются через /v1/organizations/plugins/{plugin_id}/installation_settings/{target}.

Принимаемые учётные данные: ключ Admin API с областью write:plugins.

Каждый запрос должен содержать бета-заголовок anthropic-beta: ce-plugins-2026-09-01. Запрос без него возвращает 404 — точно так же, как если бы конечной точки не существовало. Plugins API находится в стадии бета-тестирования и доступен только организациям Claude Enterprise. Он недоступен организациям Claude Platform (Claude Console), а также организациям с включённой готовностью к HIPAA.

Parameters
--plugin-id: string⁠Path parameter

ID of the Plugin (prefixed plugin_).

--served-version-id: string

Serve this version of the Plugin (prefixed pluginver_) and pin the served version to it; latest is not accepted.

--beta: optional array of AnthropicBeta⁠Header parameter

This endpoint is in beta: requests must send ce-plugins-2026-09-01 in this header.

Returns
beta_plugin: object{ type: "plugin", id, components, 16 more }
type: "plugin"

Always plugin.

id: string

The Plugin's ID.

components: array of BetaPluginComponent { type, description, name }

What the served version contains; null when not enumerated.

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

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.

content_scan: object{ assessment, reason, status }

The served version's content scan; null when it has not been scanned.

assessment: "fail" or "pass" or "unknown" or "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" 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"
created_at: string

RFC 3339.

formatdate-time
created_by: BetaPluginUserActor or BetaPluginAPIActor

Who created the Plugin; null when no creator is recorded.

One of the following:
beta_plugin_user_actor: object{ 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.

beta_plugin_api_actor: 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.

api_key_id: string

The key's ID.

description: string

The served version's description.

display_name: string

The served version's display name.

latest_version_id: string

The newest version.

manifest_version: string

The served version's manifest version, normalized for display, or null (the Plugin Version's manifest_version says how and when).

marketplace_id: string

The ID of the plugin marketplace the Plugin lives in.

name: string

Lowercase identifier, unique within its plugin marketplace. Fixed for an organization-owned Plugin's lifetime; a member-owned Plugin's changes when its owner renames it in claude.ai, while its id stays the same.

organization_installation_preference: "auto_install" or "available" or "not_available" or "required"

Organization-owned Plugin: the organization-wide installation setting every member gets unless an RBAC Group they belong to holds its own — the Plugin's own setting, or its plugin marketplace's default. Null for a member-owned Plugin, which has shares instead. One of required, auto_install, available, not_available; a value this API does not yet name is returned as stored.

One of the following:
"auto_install"
"available"
"not_available"
"required"
organization_installation_preference_inherited: boolean

Organization-owned Plugin: true while it has no organization-wide setting of its own and organization_installation_preference is its plugin marketplace's default. Null for a member-owned Plugin.

owner: BetaPluginOwnerOrganization or BetaPluginOwnerUser

Who owns the Plugin: the organization, or the member whose personal plugin marketplace it lives in.

One of the following:
beta_plugin_owner_organization: object{ type: "organization" }
type: "organization"

The Plugin lives in a plugin marketplace the organization owns.

beta_plugin_owner_user: object{ type: "user", user_id }
type: "user"

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

user_id: string

The member's User ID.

reach: "contained" or "privileged" or "remote"

How far the served version reaches, or null if it is not classified.

remote means it declares an MCP server or a CLI. privileged means it declares no MCP server or CLI, but declares a hook, monitor, language server, or settings, or has a skill, command, or other Markdown file whose frontmatter pre-approves tools (allowed-tools with any value other than an empty one or one that names only AskUserQuestion, TodoWrite, and ToolSearch). Otherwise it is contained.

If the frontmatter of a skill, command, or other Markdown file that could change the value could not be read, or was past a size limit, the version is null or privileged (or remote, if it declares an MCP server or a CLI), not contained. The value is normally worked out when a version is stored, under the rules of that time, so an older version can be null, or contained where the same files stored today would be privileged or null.

One of the following:
"contained"
"privileged"
"remote"
served_version_id: string

The version claude.ai serves to members.

served_version_pinned: boolean

False while the served version follows each new version; true once it has been pinned to one.

updated_at: string

RFC 3339. Moves on a new version and on a served-version change; a change to the Plugin's installation settings or shares does not move it.

formatdate-time
Обновление плагина
ant beta:organization:plugins update \
  --api-key my-anthropic-api-key \
  --plugin-id plugin_id \
  --served-version-id pluginver_01KaZmQpRsTuVwXyZ2b4c6d8
Returns Examples
Response 200
{
  "id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
  "components": [
    {
      "description": "description",
      "name": "review-pr",
      "type": "skill"
    }
  ],
  "content_scan": {
    "assessment": "warn",
    "reason": "credential-exposure",
    "status": "completed"
  },
  "created_at": "2026-03-14T09:26:53.589793Z",
  "created_by": {
    "email_address": "user@example.com",
    "type": "user_actor",
    "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
  },
  "description": "Reviews pull requests against your team's conventions.",
  "display_name": "Code Review Helper",
  "latest_version_id": "pluginver_01KaZmQpRsTuVwXyZ2b4c6d8",
  "manifest_version": "1.2.0",
  "marketplace_id": "marketplace_01HxQ3v9KpZ2mTn8RwLc4Ys7",
  "name": "code-review-helper",
  "organization_installation_preference": "available",
  "organization_installation_preference_inherited": true,
  "owner": {
    "type": "organization"
  },
  "reach": "contained",
  "served_version_id": "pluginver_01K9wPcHd4Rm2Tx8Vq6Ln3Sb",
  "served_version_pinned": true,
  "type": "plugin",
  "updated_at": "2026-03-14T09:26:53.589793Z"
}