Claude Platform Docs

Validasi Arsip Marketplace Plugin

beta.organization.plugin_marketplaces.validate_archive(**kwargs) -> BetaPluginMarketplaceValidationReport
POST/v1/organizations/plugin_marketplaces/validate_archive

Memeriksa apakah marketplace plugin, yang diunggah sebagai .zip dari direktori marketplace, akan tersinkronisasi ke claude.ai, tanpa menghubungkan atau menyimpannya.

Untuk memeriksa repositori GitHub publik sebagai gantinya, gunakan Validasi Repositori Marketplace Plugin.

Laporan menyebutkan apakah marketplace.json terbentuk dengan benar, plugin mana yang akan dilewati oleh sinkronisasi beserta alasannya, dan plugin mana yang hanya akan tersinkronisasi sebagian, dengan beberapa file tidak disertakan. Arsip yang tidak dapat dibaca sebagai marketplace dilaporkan, bukan ditolak: responsnya berupa laporan dengan valid: false. Sumber plugin di luar marketplace diambil secara anonim dari GitHub, sehingga sumber privat dilaporkan sebagai tidak ditemukan; sumber di host lain tidak diambil di sini, dan laporan mencatat bahwa sumber tersebut akan diperiksa saat marketplace benar-benar disinkronkan.

Tidak ada yang dicatat di feed aktivitas Compliance API.

Untuk contoh lengkap, lihat Memvalidasi konten marketplace di panduan Plugins API.

Kredensial yang diterima: kunci API Admin dengan scope read:plugins atau write:plugins; read:org_audit dan read:compliance_org_data tidak memberikan akses ini.

Setiap permintaan harus menyertakan header beta anthropic-beta: ce-plugins-2026-09-01. Permintaan tanpa header tersebut mengembalikan 404, persis seolah-olah endpoint tidak ada. Plugins API masih dalam tahap beta dan hanya tersedia untuk organisasi Claude Enterprise. API ini tidak tersedia untuk organisasi Claude Platform (Claude Console), atau untuk organisasi yang mengaktifkan kesiapan HIPAA.

Parameters
archive: FileTypes

A .zip of the marketplace directory (its contents at the root, or wrapped in one folder as a Git host's download produces), sent as a file part with a filename; DEFLATE- or STORE-compressed, at most 32 MB. A part sent without a filename, a second archive part, or any other form field is a 400; a larger archive is a 413.

formatbinary
betas: Optional[List[AnthropicBetaParam]]⁠Header parameter

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

One of the following:
str
"message-batches-2024-09-24"
"prompt-caching-2024-07-31"
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"pdfs-2024-09-25"
"token-counting-2024-11-01"
"token-efficient-tools-2025-02-19"
"output-128k-2025-02-19"
"files-api-2025-04-14"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"extended-cache-ttl-2025-04-11"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"skills-2025-10-02"
"fast-mode-2026-02-01"
"output-300k-2026-03-24"
"user-profiles-2026-03-24"
"user-profiles-2026-08-18"
"user-profiles-2026-09-04"
"advisor-tool-2026-03-01"
"managed-agents-2026-04-01"
"cache-diagnosis-2026-04-07"
"dreaming-2026-04-21"
"thinking-token-count-2026-05-13"
"server-side-fallback-2026-06-01"
"server-side-fallback-2026-07-01"
"fallback-credit-2026-06-01"
"fallback-credit-2026-07-01"
"agent-memory-2026-07-22"
"mid-conversation-tool-changes-2026-07-01"
"compact-2026-01-12"
"computer-use-2025-11-24"
"mcp-tunnels-2026-06-22"
"structured-outputs-2025-11-13"
"task-budgets-2026-03-13"
"thinking-display-updates-2026-08-18"
"ce-user-management-2026-07-13"
"mid-conversation-output-config-2026-07-01"
"thinking-binding-controls-2026-08-01"
"mid-conversation-system-clear-at-2026-08-21"
"compact-2026-09-04"
"inline-tools-2026-09-15"
"mcp-client-2026-09-15"
"ce-plugins-2026-09-01"
"spend-limit-reads-2026-09-26"
Returns
class BetaPluginMarketplaceValidationReport: type: "plugin_marketplace_validation_report"; commit_sha; manifest_error; ... # 6 more

The outcome of validating plugin marketplace content: a report, not a stored object, so nothing in it can be retrieved afterwards.

Validasi Arsip Marketplace Plugin
import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ.get(
        "ANTHROPIC_API_KEY"
    ),  # This is the default and can be omitted
)
beta_plugin_marketplace_validation_report = (
    client.beta.organization.plugin_marketplaces.validate_archive(
        archive=b"Example data",
    )
)
print(beta_plugin_marketplace_validation_report.valid)
Returns Examples
Response 200
{
  "commit_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8",
  "manifest_error": "manifest_error",
  "manifest_error_code": "marketplace_sync_manifest_not_found",
  "plugin_errors": [
    {
      "error": "error",
      "error_code": "marketplace_sync_plugin_missing_manifest",
      "name": "name"
    }
  ],
  "plugin_warnings": [
    {
      "name": "name",
      "warnings": [
        {
          "error_code": "marketplace_sync_zipball_symlink_dangling",
          "message": "message"
        }
      ]
    }
  ],
  "ref": "main",
  "total_plugin_count": 0,
  "type": "plugin_marketplace_validation_report",
  "valid": false
}