---
title: "Restore schedule"
method: POST
path: "/v1/schedules/{scheduleId}/restore"
tags: ["Schedules"]
---

# Restore schedule

`POST /v1/schedules/{scheduleId}/restore`

## Request

- Base URL: `https://blobsrus.omniapp.co/api`
- URL: `https://blobsrus.omniapp.co/api/v1/schedules/{scheduleId}/restore`
- Auth: HTTP bearer

Restore a schedule out of the trash. It runs on its schedule again, unless it was paused before it was deleted or Omni disabled it. For example, because its Slack or Google Sheets account was disconnected.

Calling this endpoint on a schedule that isn't in the trash is safe. It returns `200` and leaves the schedule as it was, unless it can't be restored for one of the reasons below.

## Path parameters

- `scheduleId` string, uuid, required

## Response `200`

Schedule restored, or it wasn't in the trash and was left as it was

- SuccessResponse
  - `success` boolean

## Other responses

- `403`: Forbidden Possible error messages: - `User does not have permission to access this schedule` - The authenticated user is not the schedule owner and can't manage schedules - `This destination type is turned off for your organization` - The organization has turned off the schedule's destination type. Returned whether or not the schedule is in the trash. - `This delivery cannot be restored because its owner is no longer in your organization` - The schedule's owner has left the organization. Returned whether or not the schedule is in the trash.
- `404`: Not Found Possible error messages: - `Scheduled task with id <scheduleId> does not exist` - The schedule doesn't exist, belongs to a different organization, or its document is in the trash
- `405`: Method Not Allowed - Invalid HTTP method for this endpoint
- `429`: Too Many Requests - Rate limit exceeded (60 requests/minute)

## Changes

- **2026-11-03** `43290040f88f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omni/apis/omni-api/changes/v1/schedules/:scheduleId/restore/post.md)

---

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