--- title: Plugin Marketplaces url: https://platform.claude.com/docs/en/api/cli/beta/organization/plugin_marketplaces --- # Plugin Marketplaces ## List Plugin Marketplaces `$ ant beta:organization:plugin-marketplaces list` **GET** `/v1/organizations/plugin_marketplaces` List the plugin marketplaces Plugins live in, newest first: the organization's own and its members' personal ones. Plugin marketplaces are created, connected to a repository and deleted in claude.ai, not through this API. The organization's library marketplace, the organization-owned `manual` marketplace that uploads go to when no marketplace is named, is created the first time something is put in it and is listed from then on. **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. ### Parameters - `--limit: optional number` (query parameter) Number of items to return per page. Defaults to `20`. Ranges from `1` to `1000`. minimum: 1, maximum: 1000 - `--organization-id: optional string` (query parameter) 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. - `--owner-type: optional "organization" or "user"` (query parameter) `organization` for the organization's plugin marketplaces, `user` for members' personal plugin marketplaces. - `--page: optional string` (query parameter) Optionally set to the `next_page` token from the previous response. maxLength: 2048 - `--source: optional "directory" or "github" or "gitlab" or 2 more` (query parameter) Only plugin marketplaces with this `source`: `manual` for those whose Plugins are uploaded; `github`, `gitlab` or `public_git` for those synchronized from a Git repository. `directory` (Anthropic's catalog) is never listed here. - `--beta: optional array of AnthropicBeta` (header parameter) This endpoint is in beta: requests must send `ce-plugins-2026-09-01` in this header. ### Returns - `BetaPluginMarketplaceList: object` - `data: array of BetaPluginMarketplace` - `type: "plugin_marketplace"` Always `plugin_marketplace`. - `id: string` The plugin marketplace's ID, prefixed `marketplace_`. - `created_at: string` RFC 3339. format: date-time - `default_installation_preference: "auto_install" or "available" or "not_available" or "required"` Organization plugin marketplace: the organization-wide setting every Plugin in it with no setting of its own gets. Null for a member's personal plugin marketplace. 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"` - `last_sync_ended_at: string` RFC 3339. When the most recent synchronization attempt to finish did so, whatever its outcome; for a repository plugin marketplace no synchronization has run on yet, when it was created. Null for a plugin marketplace that is not synchronized from a repository. format: date-time - `last_sync_read_sha: string` The commit the last synchronization attempt that reached the repository read, whether or not its content was then accepted (see `sync_status`); an attempt that ends `failed_auth` or `failed_transient` leaves it unchanged. Null until an attempt has first read the repository, and for a plugin marketplace that is not synchronized from a repository. - `name: string` Fixed for the plugin marketplace's lifetime. - `owner: BetaPluginOwnerOrganization or BetaPluginOwnerUser` The organization, or the member whose personal plugin marketplace it is. - `beta_plugin_owner_organization: object` - `type: "organization"` The Plugin lives in a plugin marketplace the organization owns. - `beta_plugin_owner_user: object` - `type: "user"` The Plugin lives in one member's personal plugin marketplace. - `user_id: string` The member's User ID. - `source: "directory" or "github" or "gitlab" or 2 more` Where the plugin marketplace's Plugins come from: `manual` when they are uploaded; `github`, `gitlab` or `public_git` when they are synchronized from the Git repository the owner connected, into which nothing can be uploaded; `directory` is Anthropic's own catalog, which this API does not list. A value this API does not yet name is returned as stored. - `"directory"` - `"github"` - `"gitlab"` - `"manual"` - `"public_git"` - `sync_status: "failed_auth" or "failed_content" or "failed_limits" or 3 more` Outcome of the plugin marketplace's most recent synchronization: one of `success`, `in_progress`, `failed_content`, `failed_transient`, `failed_auth`, `failed_limits`; a value this API does not yet name is returned as stored. Null until a synchronization is first attempted — so always for a `manual` plugin marketplace. - `"failed_auth"` - `"failed_content"` - `"failed_limits"` - `"failed_transient"` - `"in_progress"` - `"success"` - `next_page: string` Token to provide in as `page` in the subsequent request to retrieve the next page of data. ### Example ```bash ant beta:organization:plugin-marketplaces list \ --api-key my-anthropic-api-key ``` #### Response (200) ```json { "data": [ { "id": "marketplace_01HxQ3v9KpZ2mTn8RwLc4Ys7", "created_at": "2026-03-14T09:26:53.589793Z", "default_installation_preference": "available", "last_sync_ended_at": "2026-03-14T09:26:53.589793Z", "last_sync_read_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8", "name": "engineering-tools", "owner": { "type": "organization" }, "source": "github", "sync_status": "success", "type": "plugin_marketplace" } ], "next_page": "page_MjAyNi0wOS0xNlQxNDowNTowOVo" } ``` ## Get Plugin Marketplace `$ ant beta:organization:plugin-marketplaces retrieve` **GET** `/v1/organizations/plugin_marketplaces/{marketplace_id}` Retrieve a plugin marketplace by ID. **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. ### Parameters - `--marketplace-id: string` (path parameter) ID of the plugin marketplace (prefixed `marketplace_`). - `--organization-id: optional string` (query parameter) 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. - `--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_marketplace: object` - `type: "plugin_marketplace"` Always `plugin_marketplace`. - `id: string` The plugin marketplace's ID, prefixed `marketplace_`. - `created_at: string` RFC 3339. format: date-time - `default_installation_preference: "auto_install" or "available" or "not_available" or "required"` Organization plugin marketplace: the organization-wide setting every Plugin in it with no setting of its own gets. Null for a member's personal plugin marketplace. 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"` - `last_sync_ended_at: string` RFC 3339. When the most recent synchronization attempt to finish did so, whatever its outcome; for a repository plugin marketplace no synchronization has run on yet, when it was created. Null for a plugin marketplace that is not synchronized from a repository. format: date-time - `last_sync_read_sha: string` The commit the last synchronization attempt that reached the repository read, whether or not its content was then accepted (see `sync_status`); an attempt that ends `failed_auth` or `failed_transient` leaves it unchanged. Null until an attempt has first read the repository, and for a plugin marketplace that is not synchronized from a repository. - `name: string` Fixed for the plugin marketplace's lifetime. - `owner: BetaPluginOwnerOrganization or BetaPluginOwnerUser` The organization, or the member whose personal plugin marketplace it is. - `beta_plugin_owner_organization: object` - `type: "organization"` The Plugin lives in a plugin marketplace the organization owns. - `beta_plugin_owner_user: object` - `type: "user"` The Plugin lives in one member's personal plugin marketplace. - `user_id: string` The member's User ID. - `source: "directory" or "github" or "gitlab" or 2 more` Where the plugin marketplace's Plugins come from: `manual` when they are uploaded; `github`, `gitlab` or `public_git` when they are synchronized from the Git repository the owner connected, into which nothing can be uploaded; `directory` is Anthropic's own catalog, which this API does not list. A value this API does not yet name is returned as stored. - `"directory"` - `"github"` - `"gitlab"` - `"manual"` - `"public_git"` - `sync_status: "failed_auth" or "failed_content" or "failed_limits" or 3 more` Outcome of the plugin marketplace's most recent synchronization: one of `success`, `in_progress`, `failed_content`, `failed_transient`, `failed_auth`, `failed_limits`; a value this API does not yet name is returned as stored. Null until a synchronization is first attempted — so always for a `manual` plugin marketplace. - `"failed_auth"` - `"failed_content"` - `"failed_limits"` - `"failed_transient"` - `"in_progress"` - `"success"` ### Example ```bash ant beta:organization:plugin-marketplaces retrieve \ --api-key my-anthropic-api-key \ --marketplace-id marketplace_id ``` #### Response (200) ```json { "id": "marketplace_01HxQ3v9KpZ2mTn8RwLc4Ys7", "created_at": "2026-03-14T09:26:53.589793Z", "default_installation_preference": "available", "last_sync_ended_at": "2026-03-14T09:26:53.589793Z", "last_sync_read_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8", "name": "engineering-tools", "owner": { "type": "organization" }, "source": "github", "sync_status": "success", "type": "plugin_marketplace" } ``` ## Update Plugin Marketplace `$ ant beta:organization:plugin-marketplaces update` **POST** `/v1/organizations/plugin_marketplaces/{marketplace_id}` Set the default installation setting of one of the organization's own plugin marketplaces. Every Plugin in it without a setting of its own gets this default as its organization-wide setting, including Plugins added later. Pass it as `default_installation_preference`. A member's personal marketplace cannot be updated here (403). **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. ### Parameters - `--marketplace-id: string` (path parameter) ID of the plugin marketplace (prefixed `marketplace_`). - `--default-installation-preference: "auto_install" or "available" or "not_available" or "required"` The organization-wide installation setting every Plugin in the marketplace without one of its own gets: one of `required`, `auto_install`, `available`, `not_available`. Once set it can be changed but not removed. - `--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_marketplace: object` - `type: "plugin_marketplace"` Always `plugin_marketplace`. - `id: string` The plugin marketplace's ID, prefixed `marketplace_`. - `created_at: string` RFC 3339. format: date-time - `default_installation_preference: "auto_install" or "available" or "not_available" or "required"` Organization plugin marketplace: the organization-wide setting every Plugin in it with no setting of its own gets. Null for a member's personal plugin marketplace. 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"` - `last_sync_ended_at: string` RFC 3339. When the most recent synchronization attempt to finish did so, whatever its outcome; for a repository plugin marketplace no synchronization has run on yet, when it was created. Null for a plugin marketplace that is not synchronized from a repository. format: date-time - `last_sync_read_sha: string` The commit the last synchronization attempt that reached the repository read, whether or not its content was then accepted (see `sync_status`); an attempt that ends `failed_auth` or `failed_transient` leaves it unchanged. Null until an attempt has first read the repository, and for a plugin marketplace that is not synchronized from a repository. - `name: string` Fixed for the plugin marketplace's lifetime. - `owner: BetaPluginOwnerOrganization or BetaPluginOwnerUser` The organization, or the member whose personal plugin marketplace it is. - `beta_plugin_owner_organization: object` - `type: "organization"` The Plugin lives in a plugin marketplace the organization owns. - `beta_plugin_owner_user: object` - `type: "user"` The Plugin lives in one member's personal plugin marketplace. - `user_id: string` The member's User ID. - `source: "directory" or "github" or "gitlab" or 2 more` Where the plugin marketplace's Plugins come from: `manual` when they are uploaded; `github`, `gitlab` or `public_git` when they are synchronized from the Git repository the owner connected, into which nothing can be uploaded; `directory` is Anthropic's own catalog, which this API does not list. A value this API does not yet name is returned as stored. - `"directory"` - `"github"` - `"gitlab"` - `"manual"` - `"public_git"` - `sync_status: "failed_auth" or "failed_content" or "failed_limits" or 3 more` Outcome of the plugin marketplace's most recent synchronization: one of `success`, `in_progress`, `failed_content`, `failed_transient`, `failed_auth`, `failed_limits`; a value this API does not yet name is returned as stored. Null until a synchronization is first attempted — so always for a `manual` plugin marketplace. - `"failed_auth"` - `"failed_content"` - `"failed_limits"` - `"failed_transient"` - `"in_progress"` - `"success"` ### Example ```bash ant beta:organization:plugin-marketplaces update \ --api-key my-anthropic-api-key \ --marketplace-id marketplace_id \ --default-installation-preference available ``` #### Response (200) ```json { "id": "marketplace_01HxQ3v9KpZ2mTn8RwLc4Ys7", "created_at": "2026-03-14T09:26:53.589793Z", "default_installation_preference": "available", "last_sync_ended_at": "2026-03-14T09:26:53.589793Z", "last_sync_read_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8", "name": "engineering-tools", "owner": { "type": "organization" }, "source": "github", "sync_status": "success", "type": "plugin_marketplace" } ``` ## Validate Plugin Marketplace Repository `$ ant beta:organization:plugin-marketplaces validate-repository` **POST** `/v1/organizations/plugin_marketplaces/validate_repository` Check whether a plugin marketplace held in a public GitHub repository would synchronize into claude.ai, without connecting or storing it. To check a `.zip` of the marketplace directory instead, use Validate Plugin Marketplace Archive. The report says whether `marketplace.json` is well-formed, which plugins a synchronization would skip and why, and which plugins would synchronize only in part, with some files left out. A repository that is missing, private, or has no such branch or commit is reported, not refused: the response is a report with `valid: false`. Plugin sources outside the marketplace are fetched anonymously from GitHub, so a private one is reported as not found; a source on any other host is not fetched here, and the report notes that it will be checked when the marketplace actually synchronizes. Nothing is recorded on the Compliance API activity feed. For a worked example, see [Validate marketplace content](https://platform.claude.com/docs/en/manage-claude/plugins-api?sdk_languages=cli#validate-marketplace-content) in the Plugins API guide. **Accepted credentials:** an Admin API key with the `read:plugins` or `write:plugins` scope; `read:org_audit` and `read:compliance_org_data` do not grant it. 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. ### Parameters - `--repository-url: string` The `https://` URL of a public repository on github.com that holds the marketplace. Any other host, a URL with credentials in it, or one that does not name a repository is a 400. minLength: 1 - `--ref: optional string` The branch to validate the tip of, or the full 40-character SHA of the commit to validate. When omitted, the branch a synchronization would read (usually the repository's default branch); if that is not the default branch, the report's `ref` says which branch was read. An empty string, or a value that is neither a branch name nor a 40-character SHA, is a 400. minLength: 1 - `--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_marketplace_validation_report: object` The outcome of validating plugin marketplace content: a report, not a stored object, so nothing in it can be retrieved afterwards. - `type: "plugin_marketplace_validation_report"` Always `plugin_marketplace_validation_report`. - `commit_sha: string` The full SHA of the commit that was validated: for a repository, the commit that was read; for an uploaded archive, the commit recorded in the archive's comment (as a Git host's download writes it; not verified), else null. - `manifest_error: string` Set when nothing could be validated: the repository or archive could not be read, or marketplace.json is missing, malformed or over a limit. Null otherwise. - `manifest_error_code: string` A stable identifier for `manifest_error`; null when that is. - `plugin_errors: array of BetaPluginMarketplaceValidationPluginError` One entry per plugin a synchronization would skip entirely, keyed by the plugin's name in marketplace.json. - `error: string` Why the plugin would be skipped by a synchronization. - `error_code: string` A stable identifier for the reason — the value to branch on. - `name: string` The plugin's name, as its entry in marketplace.json declares it. - `plugin_warnings: array of BetaPluginMarketplaceValidationPluginWarnings` One entry per plugin that would synchronize with some of its contents left out, keyed by the plugin's name in marketplace.json. - `name: string` The plugin's name, as its entry in marketplace.json declares it. - `warnings: array of BetaPluginMarketplaceValidationPluginWarning` The parts of the plugin a synchronization would leave out. - `error_code: string` A stable identifier for the kind of warning. - `message: string` What would be left out, and why. - `ref: string` For a repository, the branch that was read by name: the one requested, or else the branch a synchronization of this repository is set to read. Null when no branch is named or set and the repository's default branch was read, for a request by commit SHA, and for an uploaded archive. - `total_plugin_count: number` How many plugins marketplace.json declares; 0 when it could not be read. - `valid: boolean` True when marketplace.json is well-formed and no plugin would be skipped; warnings never make it false. ### Example ```bash ant beta:organization:plugin-marketplaces validate-repository \ --api-key my-anthropic-api-key \ --repository-url https://github.com/example-org/example-marketplace ``` #### Response (200) ```json { "commit_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8", "manifest_error": "manifest_error", "manifest_error_code": "marketplace_sync_manifest_not_found", "plugin_errors": [ { "error": "error", "error_code": "marketplace_sync_plugin_missing_manifest", "name": "name" } ], "plugin_warnings": [ { "name": "name", "warnings": [ { "error_code": "marketplace_sync_zipball_symlink_dangling", "message": "message" } ] } ], "ref": "main", "total_plugin_count": 0, "type": "plugin_marketplace_validation_report", "valid": false } ``` ## Validate Plugin Marketplace Archive `$ ant beta:organization:plugin-marketplaces validate-archive` **POST** `/v1/organizations/plugin_marketplaces/validate_archive` Check whether a plugin marketplace, uploaded as a `.zip` of the marketplace directory, would synchronize into claude.ai, without connecting or storing it. To check a public GitHub repository instead, use Validate Plugin Marketplace Repository. The report says whether `marketplace.json` is well-formed, which plugins a synchronization would skip and why, and which plugins would synchronize only in part, with some files left out. An archive that cannot be read as a marketplace is reported, not refused: the response is a report with `valid: false`. Plugin sources outside the marketplace are fetched anonymously from GitHub, so a private one is reported as not found; a source on any other host is not fetched here, and the report notes that it will be checked when the marketplace actually synchronizes. Nothing is recorded on the Compliance API activity feed. For a worked example, see [Validate marketplace content](https://platform.claude.com/docs/en/manage-claude/plugins-api?sdk_languages=cli#validate-marketplace-content) in the Plugins API guide. **Accepted credentials:** an Admin API key with the `read:plugins` or `write:plugins` scope; `read:org_audit` and `read:compliance_org_data` do not grant it. 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. ### Parameters - `--archive: string` A .zip of the marketplace directory (its contents at the root, or wrapped in one folder as a Git host's download produces), sent as a file part with a filename; DEFLATE- or STORE-compressed, at most 32 MB. A part sent without a filename, a second archive part, or any other form field is a 400; a larger archive is a 413. format: binary - `--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_marketplace_validation_report: object` The outcome of validating plugin marketplace content: a report, not a stored object, so nothing in it can be retrieved afterwards. - `type: "plugin_marketplace_validation_report"` Always `plugin_marketplace_validation_report`. - `commit_sha: string` The full SHA of the commit that was validated: for a repository, the commit that was read; for an uploaded archive, the commit recorded in the archive's comment (as a Git host's download writes it; not verified), else null. - `manifest_error: string` Set when nothing could be validated: the repository or archive could not be read, or marketplace.json is missing, malformed or over a limit. Null otherwise. - `manifest_error_code: string` A stable identifier for `manifest_error`; null when that is. - `plugin_errors: array of BetaPluginMarketplaceValidationPluginError` One entry per plugin a synchronization would skip entirely, keyed by the plugin's name in marketplace.json. - `error: string` Why the plugin would be skipped by a synchronization. - `error_code: string` A stable identifier for the reason — the value to branch on. - `name: string` The plugin's name, as its entry in marketplace.json declares it. - `plugin_warnings: array of BetaPluginMarketplaceValidationPluginWarnings` One entry per plugin that would synchronize with some of its contents left out, keyed by the plugin's name in marketplace.json. - `name: string` The plugin's name, as its entry in marketplace.json declares it. - `warnings: array of BetaPluginMarketplaceValidationPluginWarning` The parts of the plugin a synchronization would leave out. - `error_code: string` A stable identifier for the kind of warning. - `message: string` What would be left out, and why. - `ref: string` For a repository, the branch that was read by name: the one requested, or else the branch a synchronization of this repository is set to read. Null when no branch is named or set and the repository's default branch was read, for a request by commit SHA, and for an uploaded archive. - `total_plugin_count: number` How many plugins marketplace.json declares; 0 when it could not be read. - `valid: boolean` True when marketplace.json is well-formed and no plugin would be skipped; warnings never make it false. ### Example ```bash ant beta:organization:plugin-marketplaces validate-archive \ --api-key my-anthropic-api-key \ --archive 'Example data' ``` #### Response (200) ```json { "commit_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8", "manifest_error": "manifest_error", "manifest_error_code": "marketplace_sync_manifest_not_found", "plugin_errors": [ { "error": "error", "error_code": "marketplace_sync_plugin_missing_manifest", "name": "name" } ], "plugin_warnings": [ { "name": "name", "warnings": [ { "error_code": "marketplace_sync_zipball_symlink_dangling", "message": "message" } ] } ], "ref": "main", "total_plugin_count": 0, "type": "plugin_marketplace_validation_report", "valid": false } ``` ## Domain types ### Beta Plugin Marketplace - `beta_plugin_marketplace: object` - `type: "plugin_marketplace"` Always `plugin_marketplace`. - `id: string` The plugin marketplace's ID, prefixed `marketplace_`. - `created_at: string` RFC 3339. format: date-time - `default_installation_preference: "auto_install" or "available" or "not_available" or "required"` Organization plugin marketplace: the organization-wide setting every Plugin in it with no setting of its own gets. Null for a member's personal plugin marketplace. 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"` - `last_sync_ended_at: string` RFC 3339. When the most recent synchronization attempt to finish did so, whatever its outcome; for a repository plugin marketplace no synchronization has run on yet, when it was created. Null for a plugin marketplace that is not synchronized from a repository. format: date-time - `last_sync_read_sha: string` The commit the last synchronization attempt that reached the repository read, whether or not its content was then accepted (see `sync_status`); an attempt that ends `failed_auth` or `failed_transient` leaves it unchanged. Null until an attempt has first read the repository, and for a plugin marketplace that is not synchronized from a repository. - `name: string` Fixed for the plugin marketplace's lifetime. - `owner: BetaPluginOwnerOrganization or BetaPluginOwnerUser` The organization, or the member whose personal plugin marketplace it is. - `beta_plugin_owner_organization: object` - `type: "organization"` The Plugin lives in a plugin marketplace the organization owns. - `beta_plugin_owner_user: object` - `type: "user"` The Plugin lives in one member's personal plugin marketplace. - `user_id: string` The member's User ID. - `source: "directory" or "github" or "gitlab" or 2 more` Where the plugin marketplace's Plugins come from: `manual` when they are uploaded; `github`, `gitlab` or `public_git` when they are synchronized from the Git repository the owner connected, into which nothing can be uploaded; `directory` is Anthropic's own catalog, which this API does not list. A value this API does not yet name is returned as stored. - `"directory"` - `"github"` - `"gitlab"` - `"manual"` - `"public_git"` - `sync_status: "failed_auth" or "failed_content" or "failed_limits" or 3 more` Outcome of the plugin marketplace's most recent synchronization: one of `success`, `in_progress`, `failed_content`, `failed_transient`, `failed_auth`, `failed_limits`; a value this API does not yet name is returned as stored. Null until a synchronization is first attempted — so always for a `manual` plugin marketplace. - `"failed_auth"` - `"failed_content"` - `"failed_limits"` - `"failed_transient"` - `"in_progress"` - `"success"` ### Beta Plugin Marketplace Validation Plugin Error - `beta_plugin_marketplace_validation_plugin_error: object` - `error: string` Why the plugin would be skipped by a synchronization. - `error_code: string` A stable identifier for the reason — the value to branch on. - `name: string` The plugin's name, as its entry in marketplace.json declares it. ### Beta Plugin Marketplace Validation Plugin Warning - `beta_plugin_marketplace_validation_plugin_warning: object` - `error_code: string` A stable identifier for the kind of warning. - `message: string` What would be left out, and why. ### Beta Plugin Marketplace Validation Plugin Warnings - `beta_plugin_marketplace_validation_plugin_warnings: object` - `name: string` The plugin's name, as its entry in marketplace.json declares it. - `warnings: array of BetaPluginMarketplaceValidationPluginWarning` The parts of the plugin a synchronization would leave out. - `error_code: string` A stable identifier for the kind of warning. - `message: string` What would be left out, and why. ### Beta Plugin Marketplace Validation Report - `beta_plugin_marketplace_validation_report: object` The outcome of validating plugin marketplace content: a report, not a stored object, so nothing in it can be retrieved afterwards. - `type: "plugin_marketplace_validation_report"` Always `plugin_marketplace_validation_report`. - `commit_sha: string` The full SHA of the commit that was validated: for a repository, the commit that was read; for an uploaded archive, the commit recorded in the archive's comment (as a Git host's download writes it; not verified), else null. - `manifest_error: string` Set when nothing could be validated: the repository or archive could not be read, or marketplace.json is missing, malformed or over a limit. Null otherwise. - `manifest_error_code: string` A stable identifier for `manifest_error`; null when that is. - `plugin_errors: array of BetaPluginMarketplaceValidationPluginError` One entry per plugin a synchronization would skip entirely, keyed by the plugin's name in marketplace.json. - `error: string` Why the plugin would be skipped by a synchronization. - `error_code: string` A stable identifier for the reason — the value to branch on. - `name: string` The plugin's name, as its entry in marketplace.json declares it. - `plugin_warnings: array of BetaPluginMarketplaceValidationPluginWarnings` One entry per plugin that would synchronize with some of its contents left out, keyed by the plugin's name in marketplace.json. - `name: string` The plugin's name, as its entry in marketplace.json declares it. - `warnings: array of BetaPluginMarketplaceValidationPluginWarning` The parts of the plugin a synchronization would leave out. - `error_code: string` A stable identifier for the kind of warning. - `message: string` What would be left out, and why. - `ref: string` For a repository, the branch that was read by name: the one requested, or else the branch a synchronization of this repository is set to read. Null when no branch is named or set and the repository's default branch was read, for a request by commit SHA, and for an uploaded archive. - `total_plugin_count: number` How many plugins marketplace.json declares; 0 when it could not be read. - `valid: boolean` True when marketplace.json is well-formed and no plugin would be skipped; warnings never make it false.