플러그인 설치 설정 지정
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
Returns
플러그인 설치 설정 지정
require "anthropic"
anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key")
beta_plugin_installation_setting = anthropic.beta.organization.plugins.installation_settings.set(
"target",
plugin_id: "plugin_id",
installation_preference: :required
)
puts(beta_plugin_installation_setting)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"
}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"
}