플러그인 설치 설정 지정
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}
Requires
anthropic-beta: ce-plugins-2026-09-01. Learn how to send beta headers.조직 전체 또는 하나의 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 준비가 활성화된 조직에서는 사용할 수 없습니다.
Path parameters
Headers
Body
Returns
플러그인 설치 설정 지정
curl https://api.anthropic.com/v1/organizations/plugins/$PLUGIN_ID/installation_settings/$TARGET \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2026-10-21' \
-H 'anthropic-beta: ce-plugins-2026-09-01' \
-H "Authorization: Bearer $ANTHROPIC_API_KEY" \
-d '{
"installation_preference": "required"
}'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"
}