Claude Platform Docs

Aggiorna marketplace di plugin

$ ant beta:organization:plugin-marketplaces update
POST/v1/organizations/plugin_marketplaces/{marketplace_id}

Imposta l'impostazione di installazione predefinita di uno dei marketplace di plugin dell'organizzazione. Ogni Plugin al suo interno senza un'impostazione propria riceve questo valore predefinito come impostazione a livello di organizzazione, inclusi i Plugin aggiunti in seguito.

Passalo come default_installation_preference. Il marketplace personale di un membro non può essere aggiornato qui (403).

Credenziali accettate: una chiave API Admin con lo scope write:plugins.

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
--marketplace-id: string⁠Path parameter

ID of the plugin marketplace (prefixed marketplace_).

--default-installation-preference: "auto_install" or "available" or "not_available" or "required"

The organization-wide installation setting every Plugin in the marketplace without one of its own gets: one of required, auto_install, available, not_available. Once set it can be changed but not removed.

--beta: optional array of AnthropicBeta⁠Header parameter

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

Returns
beta_plugin_marketplace: object{ type: "plugin_marketplace", id, created_at, 7 more }
type: "plugin_marketplace"

Always plugin_marketplace.

id: string

The plugin marketplace's ID, prefixed marketplace_.

created_at: string

RFC 3339.

formatdate-time
default_installation_preference: "auto_install" or "available" or "not_available" or "required"

Organization plugin marketplace: the organization-wide setting every Plugin in it with no setting of its own gets. Null for a member's personal plugin marketplace. One of required, auto_install, available, not_available; a value this API does not yet name is returned as stored.

One of the following:
"auto_install"
"available"
"not_available"
"required"
last_sync_ended_at: string

RFC 3339. When the most recent synchronization attempt to finish did so, whatever its outcome; for a repository plugin marketplace no synchronization has run on yet, when it was created. Null for a plugin marketplace that is not synchronized from a repository.

formatdate-time
last_sync_read_sha: string

The commit the last synchronization attempt that reached the repository read, whether or not its content was then accepted (see sync_status); an attempt that ends failed_auth or failed_transient leaves it unchanged. Null until an attempt has first read the repository, and for a plugin marketplace that is not synchronized from a repository.

name: string

Fixed for the plugin marketplace's lifetime.

owner: BetaPluginOwnerOrganization or BetaPluginOwnerUser

The organization, or the member whose personal plugin marketplace it is.

One of the following:
beta_plugin_owner_organization: object{ type: "organization" }
type: "organization"

The Plugin lives in a plugin marketplace the organization owns.

beta_plugin_owner_user: object{ type: "user", user_id }
type: "user"

The Plugin lives in one member's personal plugin marketplace.

user_id: string

The member's User ID.

source: "directory" or "github" or "gitlab" or 2 more

Where the plugin marketplace's Plugins come from: manual when they are uploaded; github, gitlab or public_git when they are synchronized from the Git repository the owner connected, into which nothing can be uploaded; directory is Anthropic's own catalog, which this API does not list. A value this API does not yet name is returned as stored.

One of the following:
"directory"
"github"
"gitlab"
"manual"
"public_git"
sync_status: "failed_auth" or "failed_content" or "failed_limits" or 3 more

Outcome of the plugin marketplace's most recent synchronization: one of success, in_progress, failed_content, failed_transient, failed_auth, failed_limits; a value this API does not yet name is returned as stored. Null until a synchronization is first attempted — so always for a manual plugin marketplace.

One of the following:
"failed_auth"
"failed_content"
"failed_limits"
"failed_transient"
"in_progress"
"success"
Aggiorna marketplace di plugin
ant beta:organization:plugin-marketplaces update \
  --api-key my-anthropic-api-key \
  --marketplace-id marketplace_id \
  --default-installation-preference available
Returns Examples
Response 200
{
  "id": "marketplace_01HxQ3v9KpZ2mTn8RwLc4Ys7",
  "created_at": "2026-03-14T09:26:53.589793Z",
  "default_installation_preference": "available",
  "last_sync_ended_at": "2026-03-14T09:26:53.589793Z",
  "last_sync_read_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8",
  "name": "engineering-tools",
  "owner": {
    "type": "organization"
  },
  "source": "github",
  "sync_status": "success",
  "type": "plugin_marketplace"
}