Content Management API > Plugin

Update a plugin

Body parameters

type string Required

Must be exactly "plugin".

attributes.name string Optional

The name of the plugin

Example:

"5 stars"

attributes.description null, string Optional

A description of the plugin

Example:

"A better rating experience!"

attributes.url string Optional

The entry point URL of the plugin

Example:

"https://cdn.rawgit.com/datocms/extensions/master/samples/five-stars/extension.ts"

attributes.package_name string Optional

Turns a private plugin into a Marketplace plugin, installing the specified package from the DatoCMS Marketplace. Only accepted for private, non-legacy plugins, and cannot be combined with other attributes (except enabled). Name, description, URL, version and permissions are replaced with the ones published in the Marketplace, while the existing parameters are preserved.

Example:

"datocms-plugin-star-rating-editor"

attributes.parameters object Optional

Global plugin configuration. Plugins can persist whatever information they want in this object to reuse it later. Refer to the CMA for details about technical limits.

Example:

{ devMode: true }

attributes.package_version null, string Optional

The installed version of the plugin (or null if it's a private plugin)

Example:

"0.0.4"

attributes.permissions Optional

Permissions granted to this plugin

Type: Array<string>

attributes.enabled boolean Optional

Whether the plugin is enabled or not. When disabled, the plugin behaves as if it didn't exist: fields using it as editor/addon fall back to the default editor, and any sidebar panel/page/config screen/asset source it registers does not render.

Returns

Returns a resource object of type plugin.

Examples

1
PUT https://site-api.datocms.com/plugins/:plugin_id HTTP/1.1
2
Authorization: Bearer YOUR-API-TOKEN
3
Accept: application/json
4
X-Api-Version: 3
5
Content-Type: application/vnd.api+json
6

7
{
8
  "data": {
9
    "type": "plugin",
10
    "id": "RMAMRffBRlmBuDlQsIWZ0g",
11
    "attributes": {}
12
  }
13
}

1
curl -g 'https://site-api.datocms.com/plugins/:plugin_id' \
2
  -X PUT \
3
  -H "Authorization: Bearer YOUR-API-TOKEN" \
4
  -H "Accept: application/json" \
5
  -H "X-Api-Version: 3" \
6
  -H "Content-Type: application/vnd.api+json" \
7
  --data-binary '{"data":{"type":"plugin","id":"RMAMRffBRlmBuDlQsIWZ0g","attributes":{}}}'

1
await fetch("https://site-api.datocms.com/plugins/:plugin_id", {
2
  method: "PUT",
3
  headers: {
4
    Authorization: "Bearer YOUR-API-TOKEN",
5
    Accept: "application/json",
6
    "X-Api-Version": "3",
7
    "Content-Type": "application/vnd.api+json",
8
  },
9
  body: JSON.stringify({
10
    data: { type: "plugin", id: "RMAMRffBRlmBuDlQsIWZ0g", attributes: {} },
11
  }),
12
});

1
HTTP/1.1 200 OK
2
Content-Type: application/json
3
Cache-Control: cache-control: max-age=0, private, must-revalidate
4
X-RateLimit-Limit: 30
5
X-RateLimit-Remaining: 28
6

7
{
8
  "data": {
9
    "type": "plugin",
10
    "id": "RMAMRffBRlmBuDlQsIWZ0g",
11
    "attributes": {
12
      "name": "5 stars",
13
      "description": "A better rating experience!",
14
      "url": "https://cdn.rawgit.com/datocms/extensions/master/samples/five-stars/extension.ts",
15
      "parameters": {
16
        "devMode": true
17
      },
18
      "package_name": "datocms-plugin-star-rating-editor",
19
      "package_version": "0.0.4",
20
      "permissions": [
21
        "currentUserAccessToken"
22
      ],
23
      "enabled": true
24
    },
25
    "meta": {
26
      "version": "2"
27
    }
28
  }
29
}