Claude Platform Docs

플러그인 업데이트

$client->beta->organization->plugins->update(string pluginID, string servedVersionID, ?list<AnthropicBeta> betas): Plugin
POST/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

조직 소유 플러그인의 저장된 버전 중 구성원에게 제공할 버전을 변경합니다. 예를 들어 이전 버전으로 롤백할 때 사용합니다. 이 작업은 제공되는 버전을 고정(pin)합니다. 이후 업로드되는 버전은 저장되지만 더 이상 제공되는 버전을 변경하지 않으며, 고정은 현재 여기서나 claude.ai에서 취소할 수 없습니다.

버전을 served_version_id로 전달하세요. 롤백하려면 이전 버전을, 저장만 되고 제공되지 않은 버전의 제공을 시작하려면 이후 버전을, 제공되는 버전을 변경하지 않고 고정만 하려면 이미 제공 중인 버전을 전달합니다. 새 버전은 생성되지 않습니다.

조직에서 콘텐츠 스캔이 활성화된 경우, content_scan.status가 processing인 버전은 409로 거부됩니다(error_code scan_pending, 스캔이 완료된 후 다시 시도하세요). content_scan.status가 errored이거나 content_scan.assessment가 fail 또는 unknown인 버전은 400으로 거부됩니다(error_code scan_failed). warn은 허용됩니다. 해당 시점에 스캔 결과를 읽을 수 없는 경우에는 대신 재시도 가능한 503으로 요청이 실패합니다. 플러그인이 조직의 라이브러리 마켓플레이스에 있는 경우, 현재 제공 중인 버전이 아닌 버전에 포함된 스킬의 이름을 그 이후 조직 스킬(관리자가 claude.ai에서 조직 전체를 위해 업로드한 스킬)이 사용하게 되었다면 해당 버전도 409로 거부됩니다. 이때 error_code는 skill_name_taken이며 해당 이름은 details.skill_name에 포함됩니다. 구성원 소유 플러그인은 여기서 업데이트할 수 없습니다(403).

이 엔드포인트는 설치 설정을 기록하지 않습니다. 설치 설정은 /v1/organizations/plugins/{plugin_id}/installation_settings/{target}에서 기록됩니다.

허용되는 자격 증명: write:plugins 범위가 있는 Admin API 키.

모든 요청에는 베타 헤더 anthropic-beta: ce-plugins-2026-09-01을 포함해야 합니다. 이 헤더가 없는 요청은 엔드포인트가 존재하지 않는 것과 똑같이 404를 반환합니다. Plugins API는 베타 버전이며 Claude Enterprise 조직에서만 사용할 수 있습니다. Claude Platform(Claude Console) 조직이나 HIPAA 준비가 활성화된 조직에서는 사용할 수 없습니다.

Parameters
pluginID: string⁠Path parameter

ID of the Plugin (prefixed plugin_).

servedVersionID: string

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

betas?: optional list<AnthropicBeta>⁠Header parameter

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

Returns
class Plugin { $type = 'plugin'; $id; $components; /* 16 more */ }
플러그인 업데이트
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Anthropic\Client;
use Anthropic\Beta\AnthropicBeta;

$client = new Client(apiKey: 'my-anthropic-api-key');

$betaPlugin = $client->beta->organization->plugins->update(
  'plugin_id',
  servedVersionID: 'pluginver_01KaZmQpRsTuVwXyZ2b4c6d8',
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
);

var_dump($betaPlugin);
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_01WxYzAbCdEfGhJkMnPqRsTu"
  },
  "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"
}