---
type: api
title: Delete a plugin
description: **Spaces method and path for this operation:**
url: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/kibana/v9/operation/operation-delete-agent-builder-plugins-pluginid
resource: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/kibana/v9/operation/operation-delete-agent-builder-plugins-pluginid
products:
  - Kibana
---

# Delete a plugin

Authentication: required

Availability: Experimental since 9.4

- Server: `https://{kibana_url}`

## Paths

- `DELETE` `/api/agent_builder/plugins/{pluginId}`
- `DELETE` `/s/{space_id}/api/agent_builder/plugins/{pluginId}`

#### Path parameters

- `space_id` (string) — optional
  An identifier for the space. If `space_id` is not provided in the URL, the default space is used. Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.
- `pluginId` (string) — required
  The unique identifier of the plugin.

## Description

Delete an installed plugin by ID. This action cannot be undone. To learn more about Agent Builder plugins, refer to the [plugins documentation](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/plugins).

## Required authorization

- Privileges: `agentBuilder:write`

## Query string parameters

- `force` (boolean · default: false) — optional
  If true, removes the plugin skills from agents that use them and then deletes the plugin. If false and any agent uses the plugin skills, the request returns 409 Conflict with the list of agents.

## Header parameters

- `kbn-xsrf` (string) — required
  A required header to protect against CSRF attacks

## Response

Indicates a successful response

`application/json`

## Code examples

#### Console

```console
DELETE kbn://api/agent_builder/plugins/{id}
```

#### curl

```curl
curl \
  -X DELETE "${KIBANA_URL}/api/agent_builder/plugins/{id}" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "kbn-xsrf: true"
```

## Response examples

#### Delete plugin response

`application/json`

Example response showing that deletion of the plugin has been successful

```json
{
  "success": true
}
```