---
title: service_delete
url: "/docs/ai-agents/mcp-tools/services/service_delete/"
canonical_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/services/service_delete/
markdown_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/services/service_delete.md
summary: Delete a Service and stop its Containers.
categories:
- mcp
- reference
---

# service_delete

Delete a Service and stop its Containers. A Service with persistent storage needs storage: retain (keep the stopped Service and Volume) or delete (remove both).

| | |
|---|---|
| Access | Deletes; asks for `yes: true` |
| Same as | [`blossom service:delete`](/docs/reference/cli/service/delete/) |

## Arguments

| Argument | Type | Description |
|---|---|---|
| `id` | string | Service id. Required. |
| `storage` | string | Persistent Service only. One of: `retain`, `delete`. |
| `yes` | boolean | true once the person confirms. Required. |

## Example

```json
{"id":"service-100","yes":true}
```