Claude Platform Docs

플러그인 생성

BetaPlugin Beta.Organization.Plugins.Create(parameters, cancellationToken = default)
POST/v1/organizations/plugins
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

버전의 파일을 업로드하여 조직 소유 플러그인과 그 첫 번째 버전을 생성합니다.

업로드는 multipart/form-data 형식입니다. 버전의 파일(files, 각 파트는 files[]로 전송)과 선택적 marketplace_id 및 release_notes를 포함합니다. 매니페스트의 name이 플러그인의 name이 되며, display_name, description, manifest_version도 매니페스트에서 가져옵니다.

name에는 소문자(모든 문자 체계), 숫자, 하이픈을 최대 64자까지 사용할 수 있습니다. 대문자, 공백, 밑줄 및 기타 구두점은 거부됩니다.

name은 마켓플레이스 내에서 고유해야 합니다. 이미 사용 중인 이름이면 error_code plugin_name_taken과 함께 409가 반환되며, 플러그인이 해당 이름을 보유하고 있는 경우 details.plugin_id에 해당 플러그인의 ID가 포함됩니다. 조직의 라이브러리 마켓플레이스에 추가되는 플러그인의 스킬 중 하나가 조직 스킬(관리자가 claude.ai에서 조직 전체용으로 업로드한 스킬)과 이름이 같은 경우에도 409로 거부됩니다. 이때 error_code는 skill_name_taken이며 details.skill_name에 해당 이름이 포함됩니다. 스킬 이름을 변경하거나 claude.ai에서 조직 스킬을 제거하세요. error_code가 registration_pending인 503은 플러그인과 해당 버전이 저장되었지만(ID는 details에 있음) 아직 claude.ai에서 사용할 수 없음을 의미합니다. 생성을 재시도하지 마세요(재시도하면 plugin_name_taken이 반환됩니다). 대신 저장된 플러그인에 버전을 생성하면 생성이 완료됩니다.

실제 예시는 Plugins API 가이드의 플러그인 생성을 참조하세요.

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

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

Parameters
PluginCreateParams parameters
required IReadOnlyList<BinaryContent> files

The version's files: one part per file, the part's filename being the file's path within the Plugin (for example skills/review-pr/SKILL.md), or a single .zip or .plugin archive holding them all. On the wire each part is named files[], and a part named plain files is not read; with cURL, -F 'files[]=@SKILL.md;filename=skills/review-pr/SKILL.md'. The files must include the manifest, .claude-plugin/plugin.json.

string marketplaceID

ID of the organization-owned plugin marketplace to create the Plugin in (prefixed marketplace_). It must be a manual marketplace, one whose Plugins are uploaded rather than synchronized from a repository. When omitted, the Plugin is created in the organization's library marketplace, an organization-owned manual marketplace created on first use.

string releaseNotes

Release notes stored with the version and shown in its version history in claude.ai; up to 5,000 characters.

maxLength5000
IReadOnlyList<AnthropicBeta> betas⁠Header parameter

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

MessageBatches2024_09_24("message-batches-2024-09-24")
PromptCaching2024_07_31("prompt-caching-2024-07-31")
ComputerUse2024_10_22("computer-use-2024-10-22")
ComputerUse2025_01_24("computer-use-2025-01-24")
Pdfs2024_09_25("pdfs-2024-09-25")
TokenCounting2024_11_01("token-counting-2024-11-01")
TokenEfficientTools2025_02_19("token-efficient-tools-2025-02-19")
Output128k2025_02_19("output-128k-2025-02-19")
FilesApi2025_04_14("files-api-2025-04-14")
McpClient2025_04_04("mcp-client-2025-04-04")
McpClient2025_11_20("mcp-client-2025-11-20")
DevFullThinking2025_05_14("dev-full-thinking-2025-05-14")
InterleavedThinking2025_05_14("interleaved-thinking-2025-05-14")
CodeExecution2025_05_22("code-execution-2025-05-22")
ExtendedCacheTtl2025_04_11("extended-cache-ttl-2025-04-11")
Context1m2025_08_07("context-1m-2025-08-07")
ContextManagement2025_06_27("context-management-2025-06-27")
ModelContextWindowExceeded2025_08_26("model-context-window-exceeded-2025-08-26")
Skills2025_10_02("skills-2025-10-02")
FastMode2026_02_01("fast-mode-2026-02-01")
Output300k2026_03_24("output-300k-2026-03-24")
UserProfiles2026_03_24("user-profiles-2026-03-24")
UserProfiles2026_08_18("user-profiles-2026-08-18")
UserProfiles2026_09_04("user-profiles-2026-09-04")
AdvisorTool2026_03_01("advisor-tool-2026-03-01")
ManagedAgents2026_04_01("managed-agents-2026-04-01")
CacheDiagnosis2026_04_07("cache-diagnosis-2026-04-07")
Dreaming2026_04_21("dreaming-2026-04-21")
ThinkingTokenCount2026_05_13("thinking-token-count-2026-05-13")
ServerSideFallback2026_06_01("server-side-fallback-2026-06-01")
ServerSideFallback2026_07_01("server-side-fallback-2026-07-01")
FallbackCredit2026_06_01("fallback-credit-2026-06-01")
FallbackCredit2026_07_01("fallback-credit-2026-07-01")
AgentMemory2026_07_22("agent-memory-2026-07-22")
MidConversationToolChanges2026_07_01("mid-conversation-tool-changes-2026-07-01")
Compact2026_01_12("compact-2026-01-12")
ComputerUse2025_11_24("computer-use-2025-11-24")
McpTunnels2026_06_22("mcp-tunnels-2026-06-22")
StructuredOutputs2025_11_13("structured-outputs-2025-11-13")
TaskBudgets2026_03_13("task-budgets-2026-03-13")
ThinkingDisplayUpdates2026_08_18("thinking-display-updates-2026-08-18")
CEUserManagement2026_07_13("ce-user-management-2026-07-13")
MidConversationOutputConfig2026_07_01("mid-conversation-output-config-2026-07-01")
ThinkingBindingControls2026_08_01("thinking-binding-controls-2026-08-01")
MidConversationSystemClearAt2026_08_21("mid-conversation-system-clear-at-2026-08-21")
Compact2026_09_04("compact-2026-09-04")
InlineTools2026_09_15("inline-tools-2026-09-15")
McpClient2026_09_15("mcp-client-2026-09-15")
CEPlugins2026_09_01("ce-plugins-2026-09-01")
SpendLimitReads2026_09_26("spend-limit-reads-2026-09-26")
TelemetryDestinations2026_08_11("telemetry-destinations-2026-08-11")
Webhooks2026_10_07("webhooks-2026-10-07")
MessageThreads2026_08_12("message-threads-2026-08-12")
AnalyticsUsageCost2026_08_24("analytics-usage-cost-2026-08-24")
ExperimentalClaudeTag2026_10_21("experimental-claude-tag-2026-10-21")
Returns
class BetaPlugin { Type = "plugin"; ID; Components; /* 16 more */ }
플러그인 생성
using System;
using System.Text;
using Anthropic.Models.Beta.Organization.Plugins;

PluginCreateParams parameters = new()
{
    Files =
    [
        Encoding.UTF8.GetBytes("Example data")
    ],
};

var betaPlugin = await client.Beta.Organization.Plugins.Create(parameters);

Console.WriteLine(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"
}