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

# Delete a plugin

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

- `pluginId` (string) — required
  The unique identifier of the plugin.

## Description

Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

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`

## Authentication

- Api key: `Authorization: <value>`
  These APIs use key-based authentication. You must create an API key and use the encoded value in the request header. For example: `Authorization: ApiKey base64AccessApiKey`
- Basic: `Authorization: Basic <credentials>`

## 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

Example response showing that deletion of the plugin has been successful

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