---
title: "Delete Time Offs by date range"
method: DELETE
path: "/api/v1/timeoffs"
tags: ["TimeOffs"]
---

# Delete Time Offs by date range

`DELETE /api/v1/timeoffs`

## Request

- Base URL: `https://api-sxkan78ybekjjaveh1lcig.teamhood.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-sxkan78ybekjjaveh1lcig.teamhood.com/api/v1/timeoffs`
- Auth: API key in header `X-ApiKey`
- TypeScript: <https://skmtc.dev/teamhood/apis/teamhood-api-v1/docs/api/v1/timeoffs/delete.ts> (a function with typed inputs; its response is checked against the schema)

Deletes the time offs that lie entirely within `start`..`end` (both inclusive).
`user` is the id of any user in the tenant, including guests and disabled users; "All" deletes company-wide time offs only.
A time off shared by several users is kept for the others, and counts as deleted.
Requires a tenant API key.

## Query parameters

- `Start` string, date, required
- `End` string, date, required
- `User` string, required

## Response `200`

OK

- ExternalAPIContractsResponsesV1DeleteTimeOffsResponse
  - `deleted` integer, required

## Other responses

- `400`: The range or user is invalid.
- `403`: The API key is not a tenant API key.

## Changes

> 11 revisions in range; 1 not diffed.

- **2026-10-02** `6bff7199cae6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/teamhood/apis/teamhood-api-v1/changes/api/v1/timeoffs/delete.md)

---

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