驗證外掛程式市集封存檔
POST/v1/organizations/plugin_marketplaces/validate_archive
檢查以市集目錄 .zip 形式上傳的外掛程式市集是否能同步至 claude.ai，而不會連接或儲存該市集。
若要改為檢查公開 GitHub 儲存庫，請使用「驗證外掛程式市集儲存庫」。
報告會說明 marketplace.json 的格式是否正確、同步時會略過哪些 Plugin 及其原因，以及哪些 Plugin 只會部分同步（部分檔案會被排除）。無法作為市集讀取的封存檔會被回報而非拒絕：回應會是一份 valid: false 的報告。市集以外的 Plugin 來源會以匿名方式從 GitHub 擷取，因此私人來源會被回報為找不到；位於其他主機上的來源不會在此擷取，報告會註明將在市集實際同步時進行檢查。
不會在 Compliance API 活動摘要中記錄任何內容。
如需實際範例，請參閱 Plugins API 指南中的驗證市集內容。
**接受的憑證：**具有 read:plugins 或 write:plugins 範圍的 Admin API 金鑰；read:org_audit 和 read:compliance_org_data 不授予此權限。
每個請求都必須包含 beta 標頭 anthropic-beta: ce-plugins-2026-09-01。缺少此標頭的請求會傳回 404，與端點不存在時完全相同。Plugins API 目前為 beta 版，僅供 Claude Enterprise 組織使用。Claude Platform（Claude Console）組織或已啟用 HIPAA 就緒功能的組織無法使用。
Parameters
Returns
驗證外掛程式市集封存檔
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)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
}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
}