Claude Platform Docs

Listar compartilhamentos do Plugin

$client->beta->organization->plugins->shares->list(string pluginID, ?int limit, ?string organizationID, ?string page, ?TargetType targetType, ?list<AnthropicBeta> betas): PageCursor<BetaPluginShare>
GET/v1/organizations/plugins/{plugin_id}/shares
Requires anthropic-beta: ce-plugins-2026-09-01. 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.

Os compartilhamentos são somente leitura nesta API: os membros os concedem e retiram no claude.ai, e quem concedeu um compartilhamento é registrado no feed de atividades da Compliance API, e não no compartilhamento. Um Plugin pertencente à organização tem configurações de instalação em vez disso, então este caminho retorna 404 para ele.

Credenciais aceitas: uma chave de API de Admin com o escopo read:plugins ou read:org_audit, ou uma Compliance Access Key com o escopo read:compliance_org_data.

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_).

limit?: optional int⁠Query parameter

Number of items to return per page.

Defaults to 20. Ranges from 1 to 100.

default20
organizationID?: optional string⁠Query parameter

For a read:org_audit or read:compliance_org_data key created for all of a parent organization's linked organizations: a child organization of that parent to read instead of the organization the key was created in, given as the organization's UUID or its org_-prefixed ID. A value that is neither returns a 400; an organization that is not a child of the key's parent, or where the Plugins API is not available, returns a 404. Any other key may pass only its own organization's ID here; another organization returns a 404.

page?: optional string⁠Query parameter

Optionally set to the next_page token from the previous response.

targetType?: optional TargetType⁠Query parameter

Only shares with this kind of target: organization (every member), rbac_group (one RBAC Group), or organization_member (one member).

betas?: optional list<AnthropicBeta>⁠Header parameter

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

Returns
class BetaPluginShare { $type = 'plugin_share'; $grantedAt; $pluginID; $target; }
"plugin_share" type

Always plugin_share.

\Datetime grantedAt

When the share was given; a share whose role is later changed in claude.ai is re-granted and carries the time of that change.

string pluginID

The Plugin's ID.

Target target

Who the Plugin is shared with: organization (every member), rbac_group (one RBAC Group), or organization_member (one member).

Listar compartilhamentos do Plugin
<?php

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

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

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

$page = $client->beta->organization->plugins->shares->list(
  'plugin_id',
  limit: 1,
  organizationID: 'organization_id',
  page: 'page',
  targetType: 'organization',
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
);

var_dump($page);
Returns Examples
Response 200
{
  "data": [
    {
      "granted_at": "2026-03-14T09:26:53.589793Z",
      "plugin_id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
      "target": {
        "type": "organization"
      },
      "type": "plugin_share"
    }
  ],
  "next_page": "page_MjAyNi0wOS0xNlQxNDowNTowOVo"
}