---
title: "Delete Service"
description: "When you need to delete a service (and optionally everything underneath it), you can use the resource-api/resources/delete or /resource-api/resources/delete-recursive endpoints."
stack: "Enterprise Stack (commercial) — version 0.21.0"
stack_version: "0.21.0"
stack_comparison: https://docs.walt.id/community-vs-enterprise.md
canonical_url: https://docs.walt.id/enterprise-stack/administration/services/delete
generated: 2026-07-20
---
# Delete Service

When you need to delete a service (and optionally everything underneath it), you can use the `resource-api/resources/delete` or `/resource-api/resources/delete-recursive` endpoints.

## Delete a Service

**Option: CURL**

Endpoint: `/v1/{target}/resource-api/resources/delete` | [API Reference](https://enterprise.sandbox.walt.id/swagger/index.html#/Service%20%7C%20Resource/delete_v1__target__resource_api_resources_delete)

**Example Request**

```bash
curl -X 'DELETE' \
  'https://{orgHost}.enterprise-sandbox.waltid.dev/v1/{target}/resource-api/resources/delete' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {yourToken}'
```

**Path Parameters**

- `orgID`: Use the organization’s base URL / host alias (e.g., `test.enterprise-sandbox.waltid.dev` in sandbox).
- `target`: _resourceIdentifier_ – Fully qualified service path (`{organizationID}.{tenantID}.{serviceId}`), e.g., `test.sandbox.kms-eu`.

---

**Response Codes** 

- `202` The resource was deleted.
- `401` Invalid authentication

Use `/resource-api/resources/delete-recursive` if you need to cascade the removal to nested resources (for example, wiping stored keys when deleting a KMS). The request/response shape stays the same; only the endpoint path changes.