--- title: List Plugin Installation Settings url: https://platform.claude.com/docs/en/api/beta/organization/plugins/installation_settings/list --- # List Plugin Installation Settings **GET** `/v1/organizations/plugins/{plugin_id}/installation_settings` List an organization-owned Plugin's installation settings, which say which members it is for, most recently created first. The list holds the Plugin's own organization-wide setting (absent while the Plugin inherits its marketplace's default) and each RBAC Group's own setting. A member-owned Plugin has shares instead, so this path returns 404 for one. **Accepted credentials:** an Admin API key with the `read:plugins` or `read:org_audit` scope, or a Compliance Access Key with the `read:compliance_org_data` 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 - `plugin_id: string` ID of the Plugin (prefixed `plugin_`). ## Query parameters - `limit: optional number` Number of items to return per page. Defaults to `20`. Ranges from `1` to `100`. default: 20, minimum: 1, maximum: 100 - `organization_id: optional string` 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. A key with no organization of its own must always pass `organization_id`. - `page: optional string` Optionally set to the `next_page` token from the previous response. maxLength: 2048 - `target_type: optional "organization" or "rbac_group"` Only settings for this kind of target: `organization` (the organization-wide setting) or `rbac_group` (an RBAC Group's). - `"organization"` - `"rbac_group"` ## Headers - `"anthropic-beta": array of AnthropicBeta` This endpoint is in beta: requests must send `ce-plugins-2026-09-01` in this header. - `string` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"output-128k-2025-02-19"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"user-profiles-2026-08-18"` - `"user-profiles-2026-09-04"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"dreaming-2026-04-21"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"server-side-fallback-2026-07-01"` - `"fallback-credit-2026-06-01"` - `"fallback-credit-2026-07-01"` - `"agent-memory-2026-07-22"` - `"mid-conversation-tool-changes-2026-07-01"` - `"compact-2026-01-12"` - `"computer-use-2025-11-24"` - `"mcp-tunnels-2026-06-22"` - `"structured-outputs-2025-11-13"` - `"task-budgets-2026-03-13"` - `"thinking-display-updates-2026-08-18"` - `"mid-conversation-output-config-2026-07-01"` - `"thinking-binding-controls-2026-08-01"` - `"mid-conversation-system-clear-at-2026-08-21"` - `"compact-2026-09-04"` - `"inline-tools-2026-09-15"` - `"mcp-client-2026-09-15"` - `"ce-plugins-2026-09-01"` - `"spend-limit-reads-2026-09-26"` - `"telemetry-destinations-2026-08-11"` - `"webhooks-2026-10-07"` - `"admin-user-sign-out-2026-10-08"` - `"message-threads-2026-08-12"` - `"analytics-usage-cost-2026-08-24"` - `"experimental-claude-tag-2026-10-21"` - `"message-batches-2024-09-24"` **Deprecated**: This value is no longer needed. Remove it from your requests. - `"prompt-caching-2024-07-31"` **Deprecated**: This value is no longer needed. Remove it from your requests. - `"pdfs-2024-09-25"` **Deprecated**: This value is no longer needed. Remove it from your requests. - `"token-counting-2024-11-01"` **Deprecated**: This value is no longer needed. Remove it from your requests. - `"token-efficient-tools-2025-02-19"` **Deprecated**: This value is no longer needed. Remove it from your requests. - `"files-api-2025-04-14"` **Deprecated**: Sending this value selects the beta response shapes. Removing it moves you to the current shapes, so follow the migration steps: https://platform.claude.com/docs/en/build-with-claude/files#migrate-from-files-api-2025-04-14 - `"extended-cache-ttl-2025-04-11"` **Deprecated**: This value is no longer needed. Remove it from your requests. - `"skills-2025-10-02"` **Deprecated**: Sending this value selects the beta response shapes. Removing it moves you to the current shapes, so follow the migration steps: https://platform.claude.com/docs/en/build-with-claude/skills-guide#migrate-from-skills-2025-10-02 - `"cache-diagnosis-2026-04-07"` **Deprecated**: This value is no longer needed. Remove it from your requests. - `"ce-user-management-2026-07-13"` **Deprecated**: This value is no longer needed. Remove it from your requests. ## Returns - `data: array of BetaPluginInstallationSetting` - `type: "plugin_installation_setting"` Always `plugin_installation_setting`. default: plugin_installation_setting - `created_at: string` When the target was first given a setting for this Plugin. format: date-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. - `"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. - `BetaPluginTargetOrganization object` - `type: "organization"` Every member of the organization. default: organization - `BetaPluginTargetRBACGroup object` - `type: "rbac_group"` An RBAC Group. default: rbac_group - `rbac_group_id: string` The RBAC Group's ID. - `BetaPluginTargetOrganizationMember object` - `type: "organization_member"` One member of the organization. default: organization_member - `user_id: string` The member's User ID. - `updated_at: string` When its setting last changed. format: date-time - `next_page: string or null` Token to provide in as `page` in the subsequent request to retrieve the next page of data. ## Example ```bash curl https://api.anthropic.com/v1/organizations/plugins/$PLUGIN_ID/installation_settings \ -H 'anthropic-version: 2026-10-21' \ -H 'anthropic-beta: ce-plugins-2026-09-01' \ -H "Authorization: Bearer $ANTHROPIC_API_KEY" ``` ### Response (200) ```json { "data": [ { "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" } ], "next_page": "page_MjAyNi0wOS0xNlQxNDowNTowOVo" } ```