v1

latestSwagger 2.02026-07-17107105401.6 KB

Plugin

Install a plugin

Pulls and installs a plugin. After the plugin is installed, it can be enabled using the POST /plugins/{name}/enable endpoint.

post/plugins/pull

Query parameters

remotestring required

Remote reference for plugin to install.

The :latest tag is optional, and is used as the default if omitted.

namestring

Local name for the pulled plugin.

The :latest tag is optional, and is used as the default if omitted.

Headers

X-Registry-Authstring

A base64url-encoded auth configuration to use when pulling a plugin from a registry.

Refer to the authentication section for details.

Request body

Namestring

Descriptionstring

Valuestring[]

Example request

[
  {
    "Name": "network",
    "Description": "",
    "Value": [
      "host"
    ]
  },
  {
    "Name": "mount",
    "Description": "",
    "Value": [
      "/data"
    ]
  },
  {
    "Name": "device",
    "Description": "",
    "Value": [
      "/dev/cpu_dma_latency"
    ]
  }
]

Response

no error