---
title: "Delete Protocol Group"
method: DELETE
path: "/protocol_groups/{group_id}"
tags: ["protocol_groups"]
---

# Delete Protocol Group

`DELETE /protocol_groups/{group_id}`

Delete a protocol group.

The protocols in the group are **not** deleted — the database's
``ON DELETE SET NULL`` ungroups them, since a group is metadata about
protocols and never their owner.

Parameters
----------
group_id : str
    ID of the group to delete.

Returns
-------
dict
    Success message.

Raises
------
NotFoundError
    If the group does not exist or belongs to another organization.
ForbiddenError
    If the caller lacks ``protocol_group:delete`` in the project.

## Path parameters

- `group_id` string, required

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ionworks/apis/fastapi.md) · [All operations](https://skmtc.dev/ionworks/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ionworks/fastapi/revisions/7337a3cbdaf2/schema)