Claude Platform Docs

플러그인 설치 설정 지정

$ ant beta:organization:plugins:installation-settings set
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

조직 전체 또는 하나의 RBAC 그룹에 대한 조직 소유 플러그인의 설치 설정을 지정하거나 변경합니다.

대상이 이미 자체적으로 보유한 값을 기록하면 아무것도 변경되지 않습니다.

구성원 소유 플러그인은 설치 설정 대신 공유를 가지므로, 이 경로는 구성원 소유 플러그인에 대해 404를 반환합니다.

플러그인의 설치 설정 쓰기는 한 번에 하나씩 보내세요. 같은 플러그인에 대한 여러 쓰기가 동시에 도착하면 서버는 이를 순차적으로 처리하며, 일부는 적용하지 않고 503으로 응답할 수 있습니다. 이 503에는 x-should-retry: true가 포함되며, 해당 쓰기는 안전하게 반복할 수 있습니다. 1~2초 기다린 후 다시 보내세요.

허용되는 자격 증명: write:plugins 범위가 있는 Admin API 키.

모든 요청에는 베타 헤더 anthropic-beta: ce-plugins-2026-09-01을 포함해야 합니다. 이 헤더가 없는 요청은 엔드포인트가 존재하지 않는 것과 똑같이 404를 반환합니다. Plugins API는 베타 버전이며 Claude Enterprise 조직에서만 사용할 수 있습니다. Claude Platform(Claude Console) 조직이나 HIPAA 준비가 활성화된 조직에서는 사용할 수 없습니다.

Parameters
--plugin-id: string⁠Path parameter

ID of the Plugin (prefixed plugin_).

--target: string⁠Path parameter

The target whose setting is written: the literal organization for the Plugin's organization-wide setting, or an RBAC Group's ID (prefixed rbac_group_) for that group's own setting. Writing the organization target stops the Plugin from inheriting its marketplace's default, even when the value written equals that default.

--installation-preference: "auto_install" or "available" or "not_available" or "required"

The installation setting the target is to hold for this Plugin: one of required, auto_install, available, not_available.

--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_installation_setting: object{ type: "plugin_installation_setting", created_at, installation_preference, 3 more }

The installation setting an organization-owned Plugin holds for one target. It has no ID of its own: it is addressed by the Plugin's ID and the target.

type: "plugin_installation_setting"

Always plugin_installation_setting.

created_at: string

When the target was first given a setting for this Plugin.

formatdate-time
installation_preference: "auto_install" or "available" or "not_available" or "required"

The setting the target holds for this Plugin. 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"
plugin_id: string

The Plugin's ID.

target: BetaPluginTargetOrganization or BetaPluginTargetRBACGroup or BetaPluginTargetOrganizationMember

Whose setting this is: organization (the Plugin's own organization-wide setting) or rbac_group (one RBAC Group's own setting); organization_member does not occur here.

One of the following:
beta_plugin_target_organization: object{ type: "organization" }
type: "organization"

Every member of the organization.

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

An RBAC Group.

rbac_group_id: string

The RBAC Group's ID.

beta_plugin_target_organization_member: object{ type: "organization_member", user_id }
type: "organization_member"

One member of the organization.

user_id: string

The member's User ID.

updated_at: string

When its setting last changed.

formatdate-time
플러그인 설치 설정 지정
ant beta:organization:plugins:installation-settings set \
  --api-key my-anthropic-api-key \
  --plugin-id plugin_id \
  --target target \
  --installation-preference required
Returns Examples
Response 200
{
  "created_at": "2026-03-14T09:26:53.589793Z",
  "installation_preference": "required",
  "plugin_id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
  "target": {
    "type": "organization"
  },
  "type": "plugin_installation_setting",
  "updated_at": "2026-03-14T09:26:53.589793Z"
}