---
title: "Delete schedule"
method: DELETE
path: "/schedules"
---

# Delete schedule

`DELETE /schedules`

Delete an existing schedule for an app.

## Request body

- DeleteScheduleParams
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `ids` string[], required — The IDs of the schedules to delete.

## Response `200`

OK

- DeleteScheduleResponse
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `schedules` Schedule[], required — the schedules successfully deleted
    - `app_name` string, required — The name of the app that will be executed
    - `app_status` 'active' | 'disabled', required — The status of the app
    - `app_version` string — This property is deprecated. Schedules inherit the version from their environment. This field returns the environment's current version.
    - `created_at` string, date-time, required — The timestamp when the schedule was created
    - `cron` string, required — The cron expression defining when the app should run
    - `environment` string, required — The environment to run the app in
    - `id` string, required — The unique identifier for the schedule
    - `name` string, required — The name of this schedule
    - `overlap_policy` 'allow' | 'skip', required — The policy for handling overlapping runs
    - `owner` ScheduleOwner
      - `name` string, required — The owner's name: a user's full name (first + last) or a service account's name. Must identify exactly one member of the account.
      - `type` 'user' | 'service_account', required — The kind of owner: 'user' or 'service_account'
    - `parameters` RunParameter[] — The parameters to pass when running the app
      - `hidden` boolean — Whether this parameter is hidden/secret. Defaults to false.
      - `is_override` boolean, nullable — Whether this parameter's value was supplied as an override at run/schedule creation time (true) or comes from the app version's default (false).
      - `name` string, required
      - `value` string, required
    - `status` 'active' | 'disabled', required — The status of the schedule
    - `timezone` string, required — The IANA timezone identifier that the cron expression is evaluated in (e.g., 'America/New_York', 'Europe/London'). Defaults to 'UTC'.
    - `updated_at` string, date-time, required — The timestamp when the schedule was last updated

## Other responses

- `default` — Error

---

[API](https://skmtc.net/tower/apis/tower-api.md) · [All operations](https://skmtc.net/tower/apis/tower-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tower/tower-api/revisions/0e42b0fb26d9/schema)