---
title: "Void a posted gratuity by its gratuityId"
method: DELETE
path: "/folio/v1/gratuities/{gratuityId}"
tags: ["Gratuities"]
---

# Void a posted gratuity by its gratuityId

`DELETE /folio/v1/gratuities/{gratuityId}`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/folio/v1/gratuities/{gratuityId}`
- Auth: OAuth 2
  - Authorization code: `https://api.cloudbeds.com/auth/oauth/authorize`
  - Token URL: `https://api.cloudbeds.com/auth/oauth/token` scopes: `write:item`

Voids a single gratuity (as returned at post time) — reverses its tip line and its tax children on both CDC and DOMAIN. Idempotent: voiding an already-voided gratuity returns 204. The gratuityId is not re-issued after void.

## Path parameters

- `gratuityId` string, required

## Headers

- `x-property-id` string, required

## Response `204`

Gratuity voided (or already voided — idempotent).

- unknown

## Other responses

- `403`: Forbidden — insufficient permissions on the requested property.
- `404`: Not found — no gratuity matches the gratuityId on this property (GRATUITY_NOT_FOUND).
- `409`: Conflict — the gratuity predates void support and cannot be voided (GRATUITY_VOID_UNAVAILABLE).
- `500`: Internal server error.

---

[API](https://skmtc.dev/cloudbeds/apis/cloudbeds-api-v2.md) - [All operations](https://skmtc.dev/cloudbeds/apis/cloudbeds-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/cloudbeds-api-v2/revisions/69bffac143cc?raw)