---
title: "system.user.removeSchedule"
description: "Allows a schedule to be deleted."
---

# system.user.removeSchedule

> Allows a schedule to be deleted.

This function is used in **Python Scripting**.

## Description
Allows a schedule to be deleted. Note that schedules which are used in Composite Schedules can not be deleted until they are removed from the Composite Schedule.

## Client Permission Restrictions
[Permission Type](ignition-modules\vision\vision-project-properties\vision-project-properties.md#vision-permissions-properties): User Management

Client access to this scripting function is blocked to users that do not meet the role/zone requirements for the above permission type. This function is unaffected when run in the Gateway scope.

## Syntax
`system.user.removeSchedule(scheduleName)`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
String | `scheduleName` | The name of the schedule to delete. Case-sensitive.

### Returns
**UIResponse** - A list of [UIResponse](https://sdk.inductiveautomation.com/javadoc/ignition81/latest/com/inductiveautomation/ignition/common/messages/UIResponse.html) objects with lists of warnings, errors, and info about the success or failure of the deletion. The contents of the lists are accessible from the getter methods.
* `getWarns()` - Returns a list of warning messages that were encountered during the deletion.
* `getErrors()` - Returns a list of error messages that were encountered during the deletion.
* `getInfos()` - Returns a list of "info" messages that were encountered during the deletion.

These messages represent normal logging events that occurred during the deletion, and can be useful when trying to visualize the events that lead up to a failure.

### Scope
Gateway, Vision Client, Perspective Session

## Code Examples
```python title="Example #1"
# This example tries to delete the schedule MySchedule, and prints the results of the action.
  
def printResponse(responseList):
    if len(responseList) > 0:
        for response in responseList:
            print "", response
    else:
        print " None"
 
scheduleName = "MySchedule"
response = system.user.removeSchedule(scheduleName)
 
warnings = response.getWarns()
print "Warnings are:"
printResponse(warnings)
 
errors = response.getErrors()
print "Errors are:"
printResponse(errors)
 
infos = response.getInfos()
print "Infos are:"
printResponse(infos)
 
"""The example above outputs the following:
Warnings are:
 None
Errors are:
 None
Infos are:
 Schedule "MySchedule" deleted.
"""
```