> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openhome.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enable or Disable Ability

> Toggle an installed Ability on or off without deleting it.

<ParamField header="X-API-KEY" type="string" required>
  Your OpenHome API key.
</ParamField>

<ParamField path="installed_cap_id" type="integer" required>
  The installed-capability ID.
</ParamField>

<ParamField body="enabled" type="boolean" required>
  `true` to enable, `false` to disable.
</ParamField>

<ParamField body="trigger_words" type="string[]" required>
  The Ability's trigger words. This must not be empty. Send the Ability's existing trigger words so they are preserved when toggling.
</ParamField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X PUT https://app.openhome.com/api/capabilities/edit-installed-capability/456/ \
    -H "X-API-KEY: YOUR_KEY" \
    -H "Content-Type: application/json" \
    -d '{"enabled": true, "trigger_words": ["weather", "forecast"]}'
  ```

  ```python Python theme={"system"}
  import requests

  requests.put(
      "https://app.openhome.com/api/capabilities/edit-installed-capability/456/",
      headers={"X-API-KEY": "YOUR_KEY"},
      json={"enabled": True, "trigger_words": ["weather", "forecast"]},
  )
  ```
</RequestExample>