---
title: "Deletes a workspace absence."
method: DELETE
path: "/workspaceabsences/{workspaceAbsenceId}"
tags: ["workspaceAbsences"]
---

# Deletes a workspace absence.

`DELETE /workspaceabsences/{workspaceAbsenceId}`

## Request

- Base URL: `https://api.awork.com/api/v1`
- URL: `https://api.awork.com/api/v1/workspaceabsences/{workspaceAbsenceId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/awork-io/apis/awork-io/docs/workspaceabsences/:workspaceAbsenceId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Deletes a workspace absence. The absence is removed from the workspace.

<Check title="Required Permissions" icon="key">The user must be an admin or have `user-planning-data:write` permissions.</Check>

## Path parameters

- `workspaceAbsenceId` string, uuid, required

## Response `204`

No Content

- object

## Other responses

- `404`: Not Found

## Changes

- **2026-09-17** `1556e0487867`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `oauth2` was added to the API
- **2026-09-12** `8e46cf415581`: 1 info
  - api operation id `DeleteWorkspaceAbsenceById` removed and replaced with `workspaceAbsences_DeleteWorkspaceAbsenceById`

[Operation history](https://skmtc.dev/awork-io/apis/awork-io/changes/workspaceabsences/:workspaceAbsenceId/delete.md)

---

[API](https://skmtc.dev/awork-io/apis/awork-io.md) - [All operations](https://skmtc.dev/awork-io/apis/awork-io/llms.txt) - [OpenAPI document](https://skmtc.dev/awork-io/apis/awork-io/revisions/81151fac7e79?raw)