---
title: "Delete a Resource Definition."
method: DELETE
path: "/orgs/{orgId}/resources/defs/{defId}"
tags: ["public", "ResourceDefinition"]
---

# Delete a Resource Definition.

`DELETE /orgs/{orgId}/resources/defs/{defId}`

If there **are no** Active Resources provisioned via the current definition, the Resource Definition is deleted immediately.

If there **are** Active Resources provisioned via the current definition, the request fails. The response will describe the changes to the affected Active Resources if operation is forced.

The request can take an optional `force` query parameter. If set to `true`, the current Resource Definition is deleted immediately even if there are Active Resources linked to it.  
The Resource Definition that has been marked for deletion cannot be used to provision new resources.

With the next deployment, matching criteria for Resources will be re-evaluated, and current Active Resources for the target environment would be either linked to another matching Resource Definition or decommissioned and created using the new or default Resource Definition (when available).

## Path parameters

- `orgId` string, required
- `defId` string, required

## Query parameters

- `force` boolean

## Response `204`

Resource Definition has been marked as deleted.

## Other responses

- `404` — A Resource Driver with the 'driverId' ID is not found or is not accessible by the organization.
- `409` — List of Active Resources that still reference this Resource Definition.
- `500` — Internal application error.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)