---
title: "PATCH /plugins/{team_name}/{plugin_kind}/{plugin_name}"
method: PATCH
path: "/plugins/{team_name}/{plugin_kind}/{plugin_name}"
tags: ["plugins"]
---

# PATCH /plugins/{team_name}/{plugin_kind}/{plugin_name}

`PATCH /plugins/{team_name}/{plugin_kind}/{plugin_name}`

Update a plugin

## Path parameters

- `team_name` string, required — The unique name for the team.
- `plugin_kind` 'source' | 'destination' | 'transformer', required — The kind of plugin, ie. source or destination.
- `plugin_name` string, required — The unique name for the plugin.

## Request body

- PluginUpdate
  - `category` 'cloud-infrastructure' | 'databases' | 'sales-marketing' | 'engineering-analytics' | 'marketing-analytics' | 'shipment-tracking' | 'product-analytics' | 'cloud-finops' | 'project-management' | 'fleet-management' | 'security' | 'data-warehouses' | 'human-resources' | 'finance' | 'customer-support' | 'other' — Supported categories for plugins
  - `price_category` 'api' | 'database' | 'free' — Supported price categories for billing
  - `tier` 'free' | 'paid' | 'open-core' — This field is deprecated, refer to `price_category` instead. This field is only kept for backward compatibility and may be removed in a future release. Supported tiers for plugins. - free: Free tier, with no paid tables. - paid: Paid tier. These plugins may have paid tables, but can also have free tables. They require login to access. - open-core: This option is deprecated, values will either be free or paid.
  - `display_name` string — The plugin's display name, as shown in the CloudQuery Hub.
  - `short_description` string — Short description of the plugin. This will be shown in the CloudQuery Hub.
  - `homepage` string
  - `repository` string
  - `logo` string — URL to the plugin's logo. This will be shown in the CloudQuery Hub.
  - `public` boolean — If plugin is not public, it won't be visible to other teams in the CloudQuery Hub.
  - `release_stage` 'coming-soon' | 'preview' | 'ga' | 'deprecated' — Official plugins can go through three release stages: Coming Soon, Preview, and GA. The Coming Soon stage is for plugins that are not yet ready for Preview, but users can subscribe to be notified when they are ready. Both Preview and GA plugins follow semantic versioning. The main differences between the two stages are: Preview plugins are still experimental and may have frequent breaking changes. Preview plugins might get deprecated due to lack of usage. Long Term Support with community Discord and bug fixes is only guaranteed for GA plugins. Premium plugins are often discounted or free during the Preview stage.
  - `usd_per_row` string — Deprecated. Update `price_category` instead.
  - `free_rows_per_month` integer — Deprecated. Update `price_category` instead.

## Response `200`

Updated

- Plugin — CloudQuery Plugin
  - `team_name` string, required — The unique name for the team.
  - `name` string, required — The unique name for the plugin.
  - `kind` 'source' | 'destination' | 'transformer', required — The kind of plugin, ie. source or destination.
  - `category` 'cloud-infrastructure' | 'databases' | 'sales-marketing' | 'engineering-analytics' | 'marketing-analytics' | 'shipment-tracking' | 'product-analytics' | 'cloud-finops' | 'project-management' | 'fleet-management' | 'security' | 'data-warehouses' | 'human-resources' | 'finance' | 'customer-support' | 'other', required — Supported categories for plugins
  - `price_category` 'api' | 'database' | 'free' — Supported price categories for billing
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `homepage` string
  - `logo` string, required
  - `display_name` string, required — The plugin's display name
  - `official` boolean, required — True if the plugin is maintained by CloudQuery, false otherwise
  - `release_stage` 'coming-soon' | 'preview' | 'ga' | 'deprecated', required — Official plugins can go through three release stages: Coming Soon, Preview, and GA. The Coming Soon stage is for plugins that are not yet ready for Preview, but users can subscribe to be notified when they are ready. Both Preview and GA plugins follow semantic versioning. The main differences between the two stages are: Preview plugins are still experimental and may have frequent breaking changes. Preview plugins might get deprecated due to lack of usage. Long Term Support with community Discord and bug fixes is only guaranteed for GA plugins. Premium plugins are often discounted or free during the Preview stage.
  - `repository` string
  - `short_description` string, required
  - `tier` 'free' | 'paid' | 'open-core', required — This field is deprecated, refer to `price_category` instead. This field is only kept for backward compatibility and may be removed in a future release. Supported tiers for plugins. - free: Free tier, with no paid tables. - paid: Paid tier. These plugins may have paid tables, but can also have free tables. They require login to access. - open-core: This option is deprecated, values will either be free or paid.
  - `public` boolean — Whether the plugin is listed in the CloudQuery Hub. If false, the plugin will not be shown in the CloudQuery Hub and will only be visible to members of the plugin's team.
  - `usd_per_row` string, required — Deprecated. Refer to `price_category` instead.
  - `free_rows_per_month` integer, required — Deprecated. Refer to `price_category` instead.

## Other responses

- `400` — Bad request
- `403` — Forbidden
- `404` — Resource not found
- `422` — UnprocessableEntity
- `500` — Internal Error

---

[API](https://skmtc.net/cloudquery/apis/cloudquery-openapi-spec.md) · [All operations](https://skmtc.net/cloudquery/apis/cloudquery-openapi-spec/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudquery/cloudquery-openapi-spec/versions/4af580f9023b/schema)