---
title: "Set the Fan Mode Setting"
method: POST
path: "/thermostats/set_fan_mode"
tags: ["/thermostats"]
---

# Set the Fan Mode Setting

`POST /thermostats/set_fan_mode`

## Request

- Base URL: `https://connect.getseam.com`
- URL: `https://connect.getseam.com/thermostats/set_fan_mode`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
- TypeScript: <https://skmtc.dev/seam/apis/seam-connect/docs/thermostats/set_fan_mode/post.ts> (a function with typed inputs; its response is checked against the schema)

Sets the [fan mode setting](/capability-guides/thermostats/configure-current-climate-settings#fan-mode-settings) for a specified [thermostat](/capability-guides/thermostats).

## Request body

- object
  - `device_id` string, uuid, required: ID of the thermostat device for which you want to set the fan mode.
  - `fan_mode` 'auto' | 'on' | 'circulate': Deprecated. Use `fan_mode_setting` instead. Fan mode setting for the thermostat, such as `auto`, `on`, or `circulate`.
  - `fan_mode_setting` 'auto' | 'on' | 'circulate': [Fan mode setting](/capability-guides/thermostats/configure-current-climate-settings#fan-mode-settings) that you want to set for the thermostat.

## Response `200`

OK

- object
  - `action_attempt` object, required: Tracks the progress of this operation. Poll using the action_attempt_id. See the [action_attempt object](/api/action_attempts/object).
    - `action_attempt_id` string, uuid, required: ID of the action attempt.
    - `action_type` 'SET_FAN_MODE', required: Type of action being tracked.
    - `status` 'pending' | 'success' | 'error', required: Current status of the action.
    - `result` object, nullable: Result payload on success.
    - `error` object, nullable: Error details on failure.
      - `type` string
      - `message` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

---

[API](https://skmtc.dev/seam/apis/seam-connect.md) - [All operations](https://skmtc.dev/seam/apis/seam-connect/llms.txt) - [OpenAPI document](https://skmtc.dev/seam/apis/seam-connect/revisions/00c35395ce12?raw)