---
title: "Delete a one-off time slot"
method: DELETE
path: "/signups/{id}/slots/{slotId}"
tags: ["Slots"]
---

# Delete a one-off time slot

`DELETE /signups/{id}/slots/{slotId}`

## Request

- Base URL: `https://thesignup.app/api/v1`
- URL: `https://thesignup.app/api/v1/signups/{id}/slots/{slotId}`
- Auth: HTTP bearer

Delete an empty one-off slot, immediately. The slot must belong to the signup in the path (a slot of another signup is `404 not_found`, and nothing is written). A date of a repeating schedule (its `seriesId` is set) is refused with `409 conflict`: cancel it instead with `POST /signups/{id}/slots/{slotId}/cancel`. A slot with registrations is also `409 conflict` — on a past date too — and nothing is deleted; remove the registrations first. So is a slot with an item scoped to it that has claims: deleting the slot would move those claims to the whole signup without telling anyone (and unlock them on a past date), so delete those items first (`DELETE /signups/{id}/items/{itemId}?release_claims=true`) or re-scope them (`PATCH /signups/{id}/items/{itemId}`). Items scoped to the slot that nobody has claimed are kept and become whole-signup items (`scope: null`) when the slot goes. Deleting by id is idempotent in effect: a second DELETE of the same slot is `404 not_found`. Notifies nobody.

## Path parameters

- `id` string, uuid, required
- `slotId` string, uuid, required

## Response `200`

The slot is gone

- DeleteSlotResponse
  - `id` string, uuid, required: The slot that was deleted.
  - `deleted` true, required: Always `true`: the row is gone.

## Other responses

- `401`: Unauthenticated — credentials missing, malformed, invalid, or revoked
- `403`: Forbidden — credentials valid but lack the required scope
- `404`: Not found
- `409`: The slot has registrations or claimed scoped items, or is a date of a repeating schedule; nothing was deleted
- `422`: Validation failed — request body / query / path is structurally wrong
- `429`: Rate limited or daily ceiling exceeded
- `500`: Internal server error

---

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