验证插件市场代码仓库
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.检查存放在公共 GitHub 代码仓库中的插件市场能否同步到 claude.ai,而不会连接或存储该市场。
如需改为检查市场目录的 .zip 文件,请使用“验证插件市场归档”。
报告会说明 marketplace.json 格式是否正确、同步时会跳过哪些插件及原因,以及哪些插件只会部分同步(部分文件被排除)。不存在、私有或没有相应分支或提交的代码仓库会在报告中指出,而不会被拒绝:响应是一份 valid: false 的报告。市场之外的插件来源会以匿名方式从 GitHub 获取,因此私有来源会被报告为未找到或需要登录 GitHub;位于其他主机上的来源不会在此处获取,报告会注明将在市场实际同步时对其进行检查。
不会在 Compliance API 活动源中记录任何内容。
有关完整示例,请参阅插件 API 指南中的验证市场内容。
接受的凭据:具有 read:plugins 或 write:plugins 作用域的 Admin API 密钥;read:org_audit 和 read:compliance_org_data 不授予此权限。
每个请求都必须包含 beta 标头 anthropic-beta: ce-plugins-2026-09-01。缺少该标头的请求将返回 404,与端点不存在时完全相同。插件 API 目前处于 beta 阶段,仅适用于 Claude Enterprise 组织。Claude Platform(Claude Console)组织以及启用了 HIPAA 就绪功能的组织无法使用。
Headers
Body
Returns
Errors
Any method can also return the general HTTP errors.
Each code below is the value of error.details.error_code in the response body.
curl https://api.anthropic.com/v1/organizations/plugin_marketplaces/validate_repository \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2026-10-21' \
-H 'anthropic-beta: ce-plugins-2026-09-01' \
-H "Authorization: Bearer $ANTHROPIC_API_KEY" \
-d '{
"repository_url": "https://github.com/example-org/example-marketplace",
"ref": "main"
}'{
"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
{
"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
}