---
title: "Delete a BadgeClass"
method: DELETE
path: "/v2/badgeclasses/ref/{ref}"
tags: ["BadgeClasses"]
---

# Delete a BadgeClass

`DELETE /v2/badgeclasses/ref/{ref}`

Restricted to owners or editors (not staff) of the corresponding Issuer.

## Path parameters

- `ref` string, required

## Query parameters

- `hard_delete` string
- `archivalNote` string

## Response `204`

BadgeClass deleted

- LegacyResponseWrapperUnit
  - `errorCode` string, nullable
  - `fieldErrors` object, required
  - `latestTermsVersion` integer, nullable
  - `nonFieldErrors` string[], required
  - `status` BadgrStatus, required
    - `description` string, required
    - `success` boolean, required
  - `timestamp` string, date-time, nullable
  - `validationErrors` string[], required
  - `warnings` object, required

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Server Error

---

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