> ## Documentation Index
> Fetch the complete documentation index at: https://seam-feat-mintlify-migration-iteration.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Activating a Climate Preset

> Learn how to activate a preconfigured climate preset immediately.

In addition to [scheduling](../creating-and-managing-thermostat-schedules) climate presets for a thermostat, you can activate a configured climate preset immediately. When you activate a climate preset, it overrides any scheduled climate preset that is already active on the thermostat.

Activating a climate preset returns an [action attempt](../../../core-concepts/action-attempts) that enables you to track the progress of the action. Poll this action attempt, until the action completes.

Further, Seam emits a [`thermostat.temperature_reached_set_point` event](/api/events/object) when the thermostat reports a temperature within 1° Celsius of the heating or cooling [set point](../understanding-thermostat-concepts/set-points) specified in the climate preset that you've activated. You can configure a [webhook](../../../developer-tools/webhooks) to watch for this event.

***

## Activate a Climate Preset

To activate a climate preset, issue a [`/thermostats/activate_climate_preset`](/api/thermostats/activate_climate_preset) request and specify the `climate_preset_key` of the desired climate preset.

<Tabs>
  <Tab title="JavaScript">
    **Request:**

    ```javascript theme={null}
    await seam.thermostats.activateClimatePreset({
      device_id: '2d488679-6f07-4810-aed2-e726872c1dd5',
      climate_preset_key: 'occupied',
    })
    ```

    **Response:**

    ```json theme={null}
    {
      "status": "success",
      "action_attempt_id": "05de2295-d1dc-4748-aae3-9931658bde20",
      "action_type": "ACTIVATE_CLIMATE_PRESET",
      "result": {},
      "error": null
    }
    ```
  </Tab>

  <Tab title="cURL">
    **Request:**

    ```bash theme={null}
    curl -X 'POST' \
      'https://connect.getseam.com/thermostats/activate_climate_preset' \
      -H 'accept: application/json' \
      -H "Authorization: Bearer ${SEAM_API_KEY}" \
      -H 'Content-Type: application/json' \
      -d '{
        "device_id": "2d488679-6f07-4810-aed2-e726872c1dd5",
        "climate_preset_key": "occupied"
    }'
    ```

    **Response:**

    ```json theme={null}
    {
      "action_attempt": {
        "status": "pending",
        "action_type": "ACTIVATE_CLIMATE_PRESET",
        "action_attempt_id": "05de2295-d1dc-4748-aae3-9931658bde20",
        "result": null,
        "error": null
      },
      "ok": true
    }
    ```
  </Tab>

  <Tab title="Python">
    **Request:**

    ```python theme={null}
    seam.thermostats.activate_climate_preset(
      device_id = "2d488679-6f07-4810-aed2-e726872c1dd5",
      climate_preset_key = "occupied"
    )
    ```

    **Response:**

    ```
    ActionAttempt(
      action_attempt_id='05de2295-d1dc-4748-aae3-9931658bde20',
      action_type='ACTIVATE_CLIMATE_PRESET',
      error={},
      result={},
      status='success'
    )
    ```
  </Tab>

  <Tab title="Ruby">
    **Request:**

    ```ruby theme={null}
    # Coming soon!
    ```

    **Response:**

    ```
    # Coming soon!
    ```
  </Tab>

  <Tab title="PHP">
    **Request:**

    ```php theme={null}
    $seam->thermostats->activate_climate_preset(
      device_id: "2d488679-6f07-4810-aed2-e726872c1dd5",
      climate_preset_key: "occupied"
    );
    ```

    **Response:**

    ```json theme={null}
    {
      "action_attempt_id": "05de2295-d1dc-4748-aae3-9931658bde20",
      "action_type": "ACTIVATE_CLIMATE_PRESET",
      "error": null,
      "result": {},
      "status": "success"
    }
    ```
  </Tab>

  <Tab title="C#">
    **Request:**

    ```java theme={null}
    // Coming soon!
    ```

    **Response:**

    ```json theme={null}
    // Coming soon!
    ```
  </Tab>
</Tabs>

***

## Poll the Action Attempt

Activating a climate preset returns an [action attempt](../../../core-concepts/action-attempts). Use the `action_attempt_id` from this response to poll the associated action attempt using the [`/action_attempts/get`](/api/action_attempts/get) request. When the activation completes successfully, the `status` of the action attempt changes to `success`.

<Tabs>
  <Tab title="JavaScript">
    **Request:**

    ```javascript theme={null}
    await seam.actionAttempts.get(
      action_attempt_id: "05de2295-d1dc-4748-aae3-9931658bde20"
    );
    ```

    **Response:**

    ```json theme={null}
    {
      "status": "success",
      "action_attempt_id": "05de2295-d1dc-4748-aae3-9931658bde20",
      "action_type": "ACTIVATE_CLIMATE_PRESET",
      "result": {},
      "error": null
    }
    ```
  </Tab>

  <Tab title="cURL">
    **Request:**

    ```bash theme={null}
    # Use GET or POST.
    curl -X 'GET' \
      'https://connect.getseam.com/action_attempts/get' \
      -H 'accept: application/json' \
      -H 'Authorization: Bearer ${SEAM_API_KEY}' \
      -H 'Content-Type: application/json' \
      -d '{
      "action_attempt_id": "05de2295-d1dc-4748-aae3-9931658bde20"
    }'
    ```

    **Response:**

    ```
    {
      "action_attempt": {
        "status": "success",
        "action_attempt_id": "05de2295-d1dc-4748-aae3-9931658bde20",
        "action_type": "ACTIVATE_CLIMATE_PRESET",
        "result": {},
        "error": null
      },
      "ok": true
    }
    ```
  </Tab>

  <Tab title="Python">
    **Request:**

    ```python theme={null}
    seam.action_attempts.get(
      action_attempt_id = "05de2295-d1dc-4748-aae3-9931658bde20"
    )
    ```

    **Response:**

    ```
    ActionAttempt(
      action_attempt_id='05de2295-d1dc-4748-aae3-9931658bde20',
      action_type='ACTIVATE_CLIMATE_PRESET',
      error={},
      result={},
      status='success'
    )
    ```
  </Tab>

  <Tab title="Ruby">
    **Request:**

    ```ruby theme={null}
    # Coming soon!
    ```

    **Response:**

    ```
    # Coming soon!
    ```
  </Tab>

  <Tab title="PHP">
    **Request:**

    ```php theme={null}
    $seam->action_attempts->get(
      action_attempt_id: "05de2295-d1dc-4748-aae3-9931658bde20"
    );
    ```

    **Response:**

    ```json theme={null}
    {
      "action_attempt_id": "05de2295-d1dc-4748-aae3-9931658bde20",
      "action_type": "ACTIVATE_CLIMATE_PRESET",
      "error": null,
      "result": {},
      "status": "success"
    }
    ```
  </Tab>

  <Tab title="C#">
    **Request:**

    ```csharp theme={null}
    // Coming soon!
    ```

    **Response:**

    ```json theme={null}
    // Coming soon!
    ```
  </Tab>
</Tabs>