# Thermostat Schedules
## The thermostat\_schedule Object
* [Properties](#properties)
* [Endpoints](#endpoints)
Represents a [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) that activates a configured [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) on a [thermostat](https://docs.seam.co/latest/capability-guides/thermostats) at a specified starting time and deactivates the climate preset at a specified ending time.
{% tabs %}
{% tab title="Thermostat Schedule" %}
A thermostat schedule resource.
```json
{
"climate_preset_key": "eco",
"created_at": "2025-06-14T16:54:17.946316Z",
"device_id": "dc1dfc4b-8082-453f-a953-276941af8650",
"ends_at": "2025-07-14T16:54:17.946313Z",
"errors": [],
"is_override_allowed": true,
"max_override_period_minutes": 90,
"name": "My Thermostat Schedule",
"starts_at": "2025-07-12T16:54:17.946313Z",
"thermostat_schedule_id": "af2cb7f7-9f28-40da-a0a0-e7a008ef7a35",
"workspace_id": "58419b36-6103-44e5-aa83-2163e90cce01"
}
```
{% endtab %}
{% endtabs %}
***
## Properties
**`climate_preset_key`** *String*
Key of the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) to use for the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules).
***
**`created_at`** *Datetime*
Date and time at which the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) was created.
***
**`device_id`** *UUID*
ID of the desired [thermostat](https://docs.seam.co/latest/capability-guides/thermostats) device.
***
**`ends_at`** *Datetime*
Date and time at which the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
***
**`errors`** *List* *of Objects*
Errors associated with the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules).
Child Object Properties
**`error_code`** *String*
Unique identifier of the type of error. Enables quick recognition and categorization of the issue.
**`message`** *String*
Detailed description of the error. Provides insights into the issue and potentially how to rectify it.
***
**`is_override_allowed`** *Boolean*
Indicates whether a person at the thermostat can change the thermostat's settings after the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) starts.
***
**`max_override_period_minutes`** *Number*
Number of minutes for which a person at the thermostat can change the thermostat's settings after the activation of the scheduled [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets). See also [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).
***
**`name`** *String*
User-friendly name to identify the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules).
***
**`starts_at`** *Datetime*
Date and time at which the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
***
**`thermostat_schedule_id`** *UUID*
ID of the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules).
***
**`workspace_id`** *UUID*
ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the thermostat schedule.
***
## Endpoints
[**`/thermostats/schedules/create`**](/latest/api/thermostats/schedules/create.md)
Creates a new [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) for a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).
[**`/thermostats/schedules/delete`**](/latest/api/thermostats/schedules/delete.md)
Deletes a [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) for a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).
[**`/thermostats/schedules/get`**](/latest/api/thermostats/schedules/get.md)
Returns a specified [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules).
[**`/thermostats/schedules/list`**](/latest/api/thermostats/schedules/list.md)
Returns a list of all [thermostat schedules](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) for a specified [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).
[**`/thermostats/schedules/update`**](/latest/api/thermostats/schedules/update.md)
Updates a specified [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules).
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.seam.co/latest/api/thermostats/schedules.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.