Claude Platform Docs

Atualizar plugin

$client->beta->organization->plugins->update(string pluginID, string servedVersionID, ?list<AnthropicBeta> betas): Plugin
POST/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. How to send beta headers

Altere qual versão armazenada de um Plugin pertencente à organização é servida aos membros, por exemplo, para reverter para uma versão anterior. Isso fixa a versão servida: uploads posteriores são armazenados, mas deixam de alterar o que é servido, e a fixação atualmente não pode ser desfeita, nem aqui nem no claude.ai.

Passe a versão como served_version_id: uma anterior para reverter, uma posterior para começar a servir uma versão que foi armazenada sem ser servida, ou a que já está sendo servida para fixá-la sem alterar o que é servido. Nenhuma nova versão é criada.

Quando a organização tem a verificação de conteúdo habilitada, uma versão cujo content_scan.status é processing é recusada com um 409 (error_code scan_pending; tente novamente quando a verificação terminar). Uma versão cujo content_scan.status é errored, ou cujo content_scan.assessment é fail ou unknown, é recusada com um 400 (error_code scan_failed); um warn é aceito. Se o resultado da verificação não puder ser lido naquele momento, a solicitação falha com um 503 que pode ser repetido. Quando o Plugin está no marketplace de biblioteca da organização, uma versão diferente da servida também é recusada com um 409 quando uma de suas skills tem um nome que uma skill da organização (uma que um administrador enviou para toda a organização no claude.ai) passou a usar: error_code skill_name_taken, com esse nome em details.skill_name. Um Plugin pertencente a um membro não pode ser atualizado aqui (403).

Este endpoint não grava configurações de instalação; elas são gravadas em /v1/organizations/plugins/{plugin_id}/installation_settings/{target}.

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

ID of the Plugin (prefixed plugin_).

servedVersionID: string

Serve this version of the Plugin (prefixed pluginver_) and pin the served version to it; latest is not accepted.

betas?: optional list<AnthropicBeta>⁠Header parameter

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

Returns
class Plugin { $type = 'plugin'; $id; $components; /* 16 more */ }
Atualizar plugin
<?php

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

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

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

$betaPlugin = $client->beta->organization->plugins->update(
  'plugin_id',
  servedVersionID: 'pluginver_01KaZmQpRsTuVwXyZ2b4c6d8',
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
);

var_dump($betaPlugin);
Returns Examples
Response 200
{
  "id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
  "components": [
    {
      "description": "description",
      "name": "review-pr",
      "type": "skill"
    }
  ],
  "content_scan": {
    "assessment": "warn",
    "reason": "credential-exposure",
    "status": "completed"
  },
  "created_at": "2026-03-14T09:26:53.589793Z",
  "created_by": {
    "email_address": "user@example.com",
    "type": "user_actor",
    "user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu"
  },
  "description": "Reviews pull requests against your team's conventions.",
  "display_name": "Code Review Helper",
  "latest_version_id": "pluginver_01KaZmQpRsTuVwXyZ2b4c6d8",
  "manifest_version": "1.2.0",
  "marketplace_id": "marketplace_01HxQ3v9KpZ2mTn8RwLc4Ys7",
  "name": "code-review-helper",
  "organization_installation_preference": "available",
  "organization_installation_preference_inherited": true,
  "owner": {
    "type": "organization"
  },
  "reach": "contained",
  "served_version_id": "pluginver_01K9wPcHd4Rm2Tx8Vq6Ln3Sb",
  "served_version_pinned": true,
  "type": "plugin",
  "updated_at": "2026-03-14T09:26:53.589793Z"
}