Remove Plugin Installation Setting
Remove an organization-owned Plugin's own installation setting for the whole organization or for one RBAC Group.
Removing the organization target returns the Plugin to its marketplace's default
installation setting and leaves the groups' settings in place. Removing a group's
setting makes the group's members fall back to the Plugin's organization-wide setting
or to the settings of their other groups.
A target that holds no setting of its own returns 404 (a Plugin that already inherits
its marketplace's default holds no organization setting), and so does a member-owned
Plugin.
A removal counts as one of the Plugin's installation-setting writes: send all of those
writes one at a time. If several arrive for the same Plugin at the same time, the server
handles them one after another and can answer some of them with 503 and
x-should-retry: true instead of applying them; wait a second or two and send the
removal again. A 404 on the repeat means the setting is already gone.
Accepted credentials: an Admin API key with the write:plugins scope.
Every request must include the beta header anthropic-beta: ce-plugins-2026-09-01. A request without it returns 404, exactly as if the endpoint did not exist. The Plugins API is in beta and is available to Claude Enterprise organizations only. It is not available to Claude Platform (Claude Console) organizations, or to organizations with HIPAA readiness enabled.
Path parameters
Headers
Returns
curl https://api.anthropic.com/v1/organizations/plugins/$PLUGIN_ID/installation_settings/$TARGET \
-X DELETE \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: ce-plugins-2026-09-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"{
"plugin_id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
"target": {
"rbac_group_id": "rbac_group_012rppKaSVsmTo6NqRDXQXNF",
"type": "rbac_group"
},
"type": "plugin_installation_setting_deleted"
}Returns Examples
{
"plugin_id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
"target": {
"rbac_group_id": "rbac_group_012rppKaSVsmTo6NqRDXQXNF",
"type": "rbac_group"
},
"type": "plugin_installation_setting_deleted"
}