# Delete a schedule

`DELETE /v1/workday/schedules/:id` calls `timeman.schedule.delete` with `{ id }`. The ID must be a positive integer. Success: `{ success: true, data: true }`. A missing schedule yields 404 ENTITY_NOT_FOUND.

**Deleting a schedule for all employees leaves the account without that schedule.** Bitrix24 enforces permissions. Vibe does not forbid an action allowed by the platform. This upstream method is undocumented; the JSON contract was probed on 2026-10-01. Creating and updating schedules are outside this interface.

## Access and errors

Key scope: `timeman`. Bitrix24 enforces user permissions. 400 INVALID_PARAMS means invalid input; 403 means missing scope or Bitrix24 permissions; writes with a READONLY key return 403 WRITE_BLOCKED_READONLY_KEY; 409 TIMEMAN_MODULE_NOT_ENABLED means unavailable Time Management; 422 BITRIX_ERROR forwards a Bitrix24 business refusal with its text. Webhook credentials are scrubbed from responses.

[All endpoints](/docs/workday/endpoints)
