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

# Delete a plugin

Availability: 9.4+

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

## Paths

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

- [Api key auth](/elastic/docs-builder/docs/4371/api/doc/kibana/authentication#apikeyauth)
- [Basic auth](/elastic/docs-builder/docs/4371/api/doc/kibana/authentication#basicauth)

#### Path Parameters

- `pluginId` (string)
  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).<br/><br/>[Required authorization] Route required privileges: agentBuilder:write.

## Query String Parameters

- `force` (boolean · default: false)
  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.

## Response

Indicates a successful response

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