---
title: "Delete a group value"
method: DELETE
path: "/groups/values"
tags: ["Groups"]
---

# Delete a group value

`DELETE /groups/values`

## Request

- Base URL: `https://api.textla.com/v1`
- URL: `https://api.textla.com/v1/groups/values`
- Auth: HTTP bearer

Deletes a group value account-wide, removing the membership from every contact. Deleting a missing value is a tolerant no-op. The required action_audit object records who and what initiated the change.

## Request body

- DeleteValueBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `action_audit` ValueActionAudit, required
    - `actor` string, required: User, API client, or system identifier that triggered the action
    - `reason` string: Optional explanation for the action
    - `source` string, required: Interface or system that initiated the action
  - `value` string, required: Reference-data value to remove

## Response `204`

No Content

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `412`: Precondition Failed
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `502`: Bad Gateway
- `503`: Service Unavailable
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/textla/apis/textla-api.md) - [All operations](https://skmtc.dev/textla/apis/textla-api/llms.txt) - [OpenAPI document](https://skmtc.dev/textla/apis/textla-api/revisions/473f03350bc1?raw)