Claude Platform Docs

Convalida repository del marketplace di plugin

$client->beta->organization->pluginMarketplaces->validateRepository(string repositoryURL, ?string ref, ?list<AnthropicBeta> betas): PluginMarketplaceValidationReport
POST/v1/organizations/plugin_marketplaces/validate_repository
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

Verifica se un marketplace di plugin contenuto in un repository GitHub pubblico verrebbe sincronizzato in claude.ai, senza collegarlo né archiviarlo.

Per verificare invece un .zip della directory del marketplace, usa Convalida archivio del marketplace di plugin.

Il report indica se marketplace.json è ben formato, quali plugin una sincronizzazione salterebbe e perché, e quali plugin verrebbero sincronizzati solo in parte, con alcuni file esclusi. Un repository mancante, privato o privo del branch o del commit indicato viene segnalato, non rifiutato: la risposta è un report con valid: false. Le origini dei plugin esterne al marketplace vengono recuperate in modo anonimo da GitHub, quindi un'origine privata viene segnalata come non trovata o come se richiedesse l'accesso a GitHub; un'origine su qualsiasi altro host non viene recuperata qui, e il report indica che verrà verificata quando il marketplace verrà effettivamente sincronizzato.

Nulla viene registrato nel feed delle attività della Compliance API.

Per un esempio pratico, consulta Convalidare il contenuto del marketplace nella guida alla Plugins API.

Credenziali accettate: una chiave API Admin con lo scope read:plugins o write:plugins; read:org_audit e read:compliance_org_data non ne concedono l'accesso.

Ogni richiesta deve includere l'header beta anthropic-beta: ce-plugins-2026-09-01. Una richiesta senza di esso restituisce 404, esattamente come se l'endpoint non esistesse. La Plugins API è in beta ed è disponibile solo per le organizzazioni Claude Enterprise. Non è disponibile per le organizzazioni Claude Platform (Claude Console), né per le organizzazioni con la predisposizione HIPAA abilitata.

Parameters
repositoryURL: string

The https:// URL of a public repository on github.com that holds the marketplace. A URL longer than 2,048 characters, on any other host or scheme, with a port other than 443 or 80, with credentials in it, or that does not name exactly owner/repo (a trailing .git or / is accepted) is a 400. A private or missing repository is reported in the response, not refused.

ref?: optional string

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, a value longer than 255 characters, or one that contains .. or a character other than ASCII letters, digits, ., _, -, +, and /, is a 400. Any other value that is not a 40-character SHA is read as a branch name; if the repository has no such branch, the response is a report with valid: false, not a 400.

betas?: optional list<AnthropicBeta>⁠Header parameter

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

Returns
class PluginMarketplaceValidationReport { $type = 'plugin_marketplace_validation_report'; $commitSha; $manifestError; /* 6 more */ }
"plugin_marketplace_validation_report" type

Always plugin_marketplace_validation_report.

?string commitSha

The full SHA of the commit that was validated: for a repository, the commit that was read; for an uploaded archive, the commit recorded in the archive's comment (as a Git host's download writes it; not verified), else null.

?string manifestError

Set when nothing could be validated: the repository or archive could not be read, or marketplace.json is missing, malformed or over a limit. Null otherwise.

?string manifestErrorCode

A stable identifier for manifest_error; null when that is.

list<PluginMarketplaceValidationPluginError> pluginErrors

One entry per plugin a synchronization would skip entirely, keyed by the plugin's name in marketplace.json.

list<PluginMarketplaceValidationPluginWarnings> pluginWarnings

One entry per plugin that would synchronize with some of its contents left out, keyed by the plugin's name in marketplace.json.

?string ref

For a repository, the branch that was read by name: the one requested, or else the branch a synchronization of this repository is set to read. Null when no branch is named or set and the repository's default branch was read, for a request by commit SHA, and for an uploaded archive.

int totalPluginCount

How many plugins marketplace.json declares; 0 when it could not be read.

bool valid

True when marketplace.json is well-formed and no plugin would be skipped; warnings never make it false.

Convalida repository del marketplace di plugin
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Anthropic\Client;
use Anthropic\Beta\AnthropicBeta;

$client = new Client(apiKey: 'my-anthropic-api-key');

$betaPluginMarketplaceValidationReport = $client
  ->beta
  ->organization
  ->pluginMarketplaces
  ->validateRepository(
  repositoryURL: 'https://github.com/example-org/example-marketplace',
  ref: 'main',
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
);

var_dump($betaPluginMarketplaceValidationReport);
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
}