---
title: "Disable a plugin"
method: POST
path: "/plugins/{name}/disable"
tags: ["Plugin"]
---

# Disable a plugin

`POST /plugins/{name}/disable`

## Path parameters

- `name` string, required

## Query parameters

- `force` boolean

## Response `200`

no error

## Other responses

- `404` — plugin is not installed
- `500` — server error

## Changes

- **2023-07-02** `e6a23692b9ef` — 1 info
  - added the new optional `query` request parameter `force`
- **2023-04-17** `b1c1fa7038d7` — 1 warning
  - deleted the `query` request parameter `force`

[Change history](https://skmtc.dev/balena-os/apis/docker-engine-api/changes/plugins/:name/disable/post.md)

---

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