Claude Platform Docs

Plugins

Criar plugin
POST/v1/organizations/plugins
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Create an organization-owned Plugin and its first version by uploading the version's files.

Obter plugin
GET/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Recupera um plugin pelo ID.

Atualizar plugin
POST/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Change which stored version of an organization-owned Plugin is served to members, for example to roll back to an earlier one. This pins the served version: later uploads are stored but no longer change what is served, and pinning cannot currently be undone, here or in claude.ai.

Listar Plugins
GET/v1/organizations/plugins
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Liste os Plugins criados na organização, do mais recente para o mais antigo: os que estão nos marketplaces de plugins da própria organização e os que estão nos marketplaces de plugins pessoais dos membros.

Excluir Plugin
DELETE/v1/organizations/plugins/{plugin_id}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Permanently delete a Plugin and every version it holds, exactly as when an administrator deletes it in claude.ai. The Plugin may belong to the organization or to a member, including a member who has since left the organization. Do not delete a Plugin only because your pipeline did not create it: a member or an administrator might have added it in claude.ai.

Models
BetaDeletedPlugin object{ type: "plugin_deleted", id }
type: "plugin_deleted"

Always plugin_deleted.

defaultplugin_deleted
id: string

The deleted Plugin's ID.

BetaPlugin object{ type: "plugin", id, components, 16 more }
BetaPluginAPIActor object{ type: "api_actor", api_key_id }
type: "api_actor"

An Admin API key, in the same form the Compliance API activity feed uses for it.

defaultapi_actor
api_key_id: string

The key's ID.

BetaPluginComponent object{ type, description, name }
type: "agent" or "cli" or "command" or 3 more

The kind of component.

One of the following:
"agent"
"cli"
"command"
"hook"
"mcp_server"
"skill"
description: string or null

What the component declares about itself; always null for MCP servers, hooks, and CLIs.

name: string

The component's name: a skill's, command's or agent's name, an MCP server's key in the manifest, the event a hook runs on, or a CLI's executable.

BetaPluginContentScan object{ assessment, reason, status }
assessment: "fail" or "pass" or "unknown" or "warn" or null

The scan's verdict; set only when status is completed. A warn can mean a fail that was allowed in claude.ai.

One of the following:
"fail"
"pass"
"unknown"
"warn"
reason: string or null

The primary mechanism behind a warn or fail, such as credential-exposure or guardrail-tampering; a mechanism this API does not yet name reads as other. Null on a pass, whenever assessment is null, and when no mechanism is reported for the verdict.

status: "completed" or "errored" or "processing"

processing while a scan runs, completed when it ran to completion, errored when it could not run. Once a scan of the version has completed, content_scan describes the newest completed scan, even while a later scan runs. While the scan outcome cannot be read, status is errored instead.

One of the following:
"completed"
"errored"
"processing"
BetaPluginNameTakenErrorDetails object{ error_code, plugin_id }

The marketplace already holds this name. plugin_id is the Plugin that holds it, and can be absent.

error_code: "plugin_name_taken"
plugin_id: optional string or null
BetaPluginOwnerOrganization object{ type: "organization" }
type: "organization"

The Plugin lives in a plugin marketplace the organization owns.

defaultorganization
BetaPluginOwnerUser object{ type: "user", user_id }
type: "user"

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

defaultuser
user_id: string

The member's User ID.

BetaPluginTargetOrganization object{ type: "organization" }
type: "organization"

Every member of the organization.

defaultorganization
BetaPluginTargetOrganizationMember object{ type: "organization_member", user_id }
type: "organization_member"

One member of the organization.

defaultorganization_member
user_id: string

The member's User ID.

BetaPluginTargetRBACGroup object{ type: "rbac_group", rbac_group_id }
type: "rbac_group"

An RBAC Group.

defaultrbac_group
rbac_group_id: string

The RBAC Group's ID.

BetaPluginUserActor object{ type: "user_actor", email_address, user_id }
type: "user_actor"

A member of the organization.

defaultuser_actor
email_address: string or null

The member's email address; may be null, for example when they are no longer a member of the organization.

user_id: string

The member's User ID.

BetaRegistrationPendingErrorDetails object{ error_code, plugin_id, plugin_version_id }

The Plugin version was stored but is not yet usable in claude.ai. plugin_id and plugin_version_id identify what was stored.

error_code: "registration_pending"
plugin_id: string
plugin_version_id: string
BetaScanFailedErrorDetails object{ error_code, plugin_version_id }

The version in plugin_version_id did not pass its content scan, so it cannot be served.

error_code: "scan_failed"
plugin_version_id: string
BetaScanPendingErrorDetails object{ error_code, plugin_version_id }

The content scan of the version in plugin_version_id is still running. Retry once the scan finishes.

error_code: "scan_pending"
plugin_version_id: string
BetaSkillNameTakenErrorDetails object{ error_code, skill_name }

One of the Plugin's skills has the name of an organization skill. skill_name is that name.

error_code: "skill_name_taken"
skill_name: string

PluginsVersões

Criar versão do Plugin
POST/v1/organizations/plugins/{plugin_id}/versions
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Add a version to an organization-owned Plugin by uploading the new version's files; it becomes the version served to members unless the Plugin's served version has been pinned.

Listar versões do Plugin
GET/v1/organizations/plugins/{plugin_id}/versions
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Liste as versões de um Plugin, da mais recente para a mais antiga.

Obter versão do Plugin
GET/v1/organizations/plugins/{plugin_id}/versions/{version}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Recupere uma versão de um Plugin pelo seu ID, ou a versão mais recente do Plugin.

Baixar arquivo da versão do Plugin
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Baixe o arquivo .zip de uma versão, exatamente como armazenado. Cada download de um Plugin do marketplace de plugins pessoal de um membro é registrado no feed de atividades da Compliance API.

PluginsConfigurações de instalação

Listar configurações de instalação do Plugin
GET/v1/organizations/plugins/{plugin_id}/installation_settings
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Liste as configurações de instalação de um Plugin pertencente à organização, que indicam para quais membros ele se destina, das criadas mais recentemente para as mais antigas.

Definir configuração de instalação do Plugin
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Defina ou altere a configuração de instalação de um Plugin pertencente à organização para toda a organização ou para um Grupo RBAC.

Remover configuração de instalação do Plugin
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Remova a configuração de instalação própria de um Plugin pertencente à organização para toda a organização ou para um Grupo RBAC.

PluginsCompartilhamentos

Listar compartilhamentos do Plugin
GET/v1/organizations/plugins/{plugin_id}/shares
Requires anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.

Liste os compartilhamentos que o proprietário de um Plugin pertencente a um membro concedeu — a todos os membros da organização, a um Grupo RBAC ou a um membro — dos concedidos mais recentemente para os mais antigos.