Cria um plugin pertencente à organização e sua primeira versão fazendo upload dos arquivos da versão.
O upload é multipart/form-data: os arquivos da versão (files, cada parte enviada
como files[]), com marketplace_id e release_notes opcionais. O name do manifesto se torna o
name do plugin, e display_name, description e manifest_version também vêm
do manifesto.
name pode conter letras minúsculas (de qualquer alfabeto), dígitos e hifens, com até
64 caracteres. Letras maiúsculas, espaços, sublinhados e outras pontuações são
rejeitados.
O name deve ser único dentro do marketplace: um nome já em uso
retorna um 409 com error_code plugin_name_taken e, quando um plugin o detém,
o ID desse plugin em details.plugin_id. Um plugin destinado ao marketplace da biblioteca
da organização também é recusado com um 409 quando uma de suas skills tem o nome de
uma skill da organização (uma skill que um administrador enviou para toda a organização
no claude.ai): error_code skill_name_taken, com esse nome em
details.skill_name; renomeie a skill ou remova a skill da organização no
claude.ai. Um 503 com error_code
registration_pending significa que o plugin e sua versão foram armazenados (seus IDs estão
em details), mas ainda não podem ser usados no claude.ai: não repita a criação (a
nova tentativa retornaria plugin_name_taken); em vez disso, crie uma versão no plugin armazenado,
o que o conclui.
Para um exemplo prático, consulte Criar um plugin no guia da API de Plugins.
Credenciais aceitas: uma chave da Admin API 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 a prontidão para HIPAA habilitada.
Parameters
Returns
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 = client.beta.organization.plugins.create(
files=[b"Example data"],
)
print(beta_plugin.id){
"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_01WCz1FkmYMm4gnmykNKUu3Q"
},
"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"
}Returns Examples
{
"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_01WCz1FkmYMm4gnmykNKUu3Q"
},
"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"
}