---
title: "Pause a schedule"
method: PATCH
path: "/scheduling/v1/schedules/{id}/pause"
tags: ["Schedules"]
---

# Pause a schedule

`PATCH /scheduling/v1/schedules/{id}/pause`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/scheduling/v1/schedules/{id}/pause`
- Auth: HTTP bearer

Pauses an active schedule so that it stops generating new occurrences. Existing occurrences are not affected. Optionally pause only the sub-schedules for specific sites or assets by setting `sites` or `assets`. The schedule can be resumed later via the Resume schedule endpoint.

## Path parameters

- `id` string, required

## Request body

- S12SchedulingV1SchedulingServicePauseScheduleBody
  - `sites` S12SchedulingV1Sites: Sites specifies a list of sites.
    - `site_ids` string[], required: A list of site IDs.
  - `assets` S12SchedulingV1Assets: Assets specifies a list of assets.
    - `asset_ids` string[], required: A list of asset IDs.

## Response `200`

A successful response.

- S12SchedulingV1PauseScheduleResponse

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `eb6bb843bf18`: 2 info
  - added the new optional request property `assets`
  - added the new optional request property `sites`

[Operation history](https://skmtc.dev/safetyculture/apis/safetyculture-api/changes/scheduling/v1/schedules/:id/pause/patch.md)

---

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