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

# Delete a Matching Criteria from a Resource Definition.

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

If there **are no** Active Resources that would match to a different Resource Definition when the current Matching Criteria is deleted, the Matching Criteria is deleted immediately.

If there **are** Active Resources that would match to a different Resource Definition, the request fails with HTTP status code 409 (Conflict). The response content will list all of affected Active Resources and their new matches.

The request can take an optional `force` query parameter. If set to `true`, the Matching Criteria is deleted immediately. Referenced Active Resources would match to a different Resource Definition during the next deployment in the target environment.

## Path parameters

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

## Query parameters

- `force` boolean

## Response `204`

Record deleted.

## Other responses

- `404` — The Resource Definition is not found.
- `409` — One or more Active Resources reference the Resource Definition through this Matching Criteria.
- `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)