Claude Platform Docs

Validar repositorio de marketplace de plugins

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

Comprueba si un marketplace de plugins alojado en un repositorio público de GitHub se sincronizaría en claude.ai, sin conectarlo ni almacenarlo.

Para comprobar en su lugar un .zip del directorio del marketplace, usa Validar archivo de marketplace de plugins.

El informe indica si marketplace.json está bien formado, qué plugins omitiría una sincronización y por qué, y qué plugins se sincronizarían solo en parte, con algunos archivos excluidos. Un repositorio que no existe, es privado o no tiene esa rama o commit se informa, no se rechaza: la respuesta es un informe con valid: false. Las fuentes de plugins fuera del marketplace se obtienen de forma anónima desde GitHub, por lo que una privada se informa como no encontrada; una fuente en cualquier otro host no se obtiene aquí, y el informe indica que se comprobará cuando el marketplace se sincronice realmente.

No se registra nada en el feed de actividad de la Compliance API.

Para ver un ejemplo práctico, consulta Validar el contenido del marketplace en la guía de la API de Plugins.

Credenciales aceptadas: una clave de API de administrador con el alcance read:plugins o write:plugins; read:org_audit y read:compliance_org_data no lo otorgan.

Cada solicitud debe incluir el encabezado beta anthropic-beta: ce-plugins-2026-09-01. Una solicitud sin él devuelve 404, exactamente como si el endpoint no existiera. La API de Plugins está en beta y solo está disponible para organizaciones de Claude Enterprise. No está disponible para organizaciones de Claude Platform (Claude Console) ni para organizaciones con la preparación para HIPAA habilitada.

Parameters
repository_url: str

The https:// URL of a public repository on github.com that holds the marketplace. Any other host, a URL with credentials in it, or one that does not name a repository is a 400.

minLength1
ref: Optional[str]

The branch to validate the tip of, or the full 40-character SHA of the commit to validate. When omitted, the branch a synchronization would read (usually the repository's default branch); if that is not the default branch, the report's ref says which branch was read. An empty string, or a value that is neither a branch name nor a 40-character SHA, is a 400.

minLength1
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.

Validar repositorio de marketplace de plugins
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_repository(
        repository_url="https://github.com/example-org/example-marketplace",
    )
)
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
}