Claude Platform Docs

Atualizar marketplace de plugins

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

Defina a configuração de instalação padrão de um dos marketplaces de plugins da própria organização. Todo Plugin nele sem uma configuração própria recebe esse padrão como sua configuração para toda a organização, incluindo Plugins adicionados posteriormente.

Passe-a como default_installation_preference. O marketplace pessoal de um membro não pode ser atualizado aqui (403).

Credenciais aceitas: uma chave de API de Admin com o escopo write:plugins.

Toda solicitação deve incluir o cabeçalho beta anthropic-beta: ce-plugins-2026-09-01. Uma solicitação sem ele retorna 404, exatamente como se o endpoint não existisse. A API de Plugins está em beta e está disponível apenas para organizações Claude Enterprise. Ela não está disponível para organizações da Claude Platform (Claude Console) nem para organizações com prontidão para HIPAA habilitada.

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"
Atualizar marketplace de plugins
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"
}