Skip to content

Remove a time slot​

DELETE
/api/time-slots/{id}

Removes the slot and moves each of its reminders to the start of the
remaining slot nearest the reminder's own time of day (a tie goes to the
earlier slot), so none drop out of every slot. Quota prompts placed in
the slot move the same way (2026-09-25): every stored prompt period
naming it — a quota's quota_prompt_config.slot_id and per-number
overrides, and the user's default prompt period — is repointed to the
remaining slot nearest the removed slot's start (quotas_moved). The
last remaining slot cannot be removed (400). Always an undo entry
(time_slot_delete, undo_id): undo restores the slot under its
original id together with its reminders and prompt placements.

Authorizations​

bearerAuth

API token created via POST /api/tokens or the db:create-token CLI command

Type
HTTP (bearer)

Responses​

The removed slot, as it was

application/json
JSON
{
"data": {
"slot": {
"id": 0,
"user_id": 0,
"label": "Early morning",
"start_time": "07:00",
"sort_order": 0,
"created_at": "string"
},
"reminders_moved": 0,
"quotas_moved": 0,
"undo_id": 0
}
}

Samples​

Powered by VitePress OpenAPI