---
title: "Switch an installed plugin on or off [write]"
method: PATCH
path: "/plugins/{name}"
---

# Switch an installed plugin on or off \[write\]

`PATCH /plugins/{name}`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/plugins/{name}`
- Auth: HTTP bearer

Off: its skills stop attaching to new sessions and plugin sessions refuse to start. A plugin a workspace admin blocked cannot be switched on (403 plugin_blocked).

## Path parameters

- `name` string, required

## Request body

- object
  - `enabled` boolean, required

## Response `200`

OK

- object
  - `name` string
  - `enabled` boolean

## Other responses

- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/plugins/:name/patch.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/0d435187cd55?raw)