Claude Platform Docs

Plugin-Marketplace-Archiv validieren

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

Prüft, ob ein Plugin-Marketplace, hochgeladen als .zip-Datei des Marketplace-Verzeichnisses, in claude.ai synchronisiert werden würde, ohne ihn zu verbinden oder zu speichern.

Um stattdessen ein öffentliches GitHub-Repository zu prüfen, verwende Validate Plugin Marketplace Repository.

Der Bericht gibt an, ob marketplace.json wohlgeformt ist, welche Plugins eine Synchronisierung überspringen würde und warum, und welche Plugins nur teilweise synchronisiert würden, wobei einige Dateien ausgelassen werden. Ein Archiv, das nicht als Marketplace gelesen werden kann, wird gemeldet, nicht abgelehnt: Die Antwort ist ein Bericht mit valid: false. Plugin-Quellen außerhalb des Marketplaces werden anonym von GitHub abgerufen, daher wird eine private als nicht gefunden gemeldet; eine Quelle auf einem anderen Host wird hier nicht abgerufen, und der Bericht vermerkt, dass sie geprüft wird, wenn der Marketplace tatsächlich synchronisiert wird.

Im Aktivitäts-Feed der Compliance API wird nichts protokolliert.

Ein ausgearbeitetes Beispiel findest du unter Marketplace-Inhalte validieren im Leitfaden zur Plugins API.

Akzeptierte Anmeldedaten: ein Admin-API-Key mit dem Scope read:plugins oder write:plugins; read:org_audit und read:compliance_org_data gewähren keinen Zugriff.

Jede Anfrage muss den Beta-Header anthropic-beta: ce-plugins-2026-09-01 enthalten. Eine Anfrage ohne ihn gibt 404 zurück, genau so, als ob der Endpunkt nicht existieren würde. Die Plugins API befindet sich in der Beta und ist nur für Claude Enterprise-Organisationen verfügbar. Sie ist nicht für Claude Platform (Claude Console)-Organisationen oder für Organisationen mit aktivierter HIPAA-Readiness verfügbar.

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.

Plugin-Marketplace-Archiv validieren
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
}