---
title: "Install a plugin"
method: POST
path: "/plugins/pull"
tags: ["Plugin"]
---

# Install a plugin

`POST /plugins/pull`

Pulls and installs a plugin. After the plugin is installed, it can be
enabled using the [`POST /plugins/{name}/enable` endpoint](#operation/PostPluginsEnable).

## Query parameters

- `remote` string, required
- `name` string

## Headers

- `X-Registry-Auth` string

## Request body

- PluginPrivilege[]
  - `Name` string
  - `Description` string
  - `Value` string[]

## Response `204`

no error

## Other responses

- `500` — server error

---

[API](https://skmtc.net/balena-os/apis/docker-engine-api.md) · [All operations](https://skmtc.net/balena-os/apis/docker-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/balena-os/docker-engine-api/versions/e20cfc2fb3f1/schema)