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,
"name": "Weather",
"category": "skill",
"trigger_words": ["weather", "forecast"],
"system_capability": false,
"agent_capability": false
}'
import requests
requests.put(
"https://app.openhome.com/api/capabilities/edit-installed-capability/456/",
headers={"X-API-KEY": "YOUR_KEY"},
json={
"enabled": True,
"name": "Weather",
"category": "skill",
"trigger_words": ["weather", "forecast"],
"system_capability": False,
"agent_capability": False,
},
)
Abilities
Enable or Disable Ability
Toggle an installed Ability on or off, or change its trigger words or category.
PUT
/
api
/
capabilities
/
edit-installed-capability
/
{installed_cap_id}
/
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,
"name": "Weather",
"category": "skill",
"trigger_words": ["weather", "forecast"],
"system_capability": false,
"agent_capability": false
}'
import requests
requests.put(
"https://app.openhome.com/api/capabilities/edit-installed-capability/456/",
headers={"X-API-KEY": "YOUR_KEY"},
json={
"enabled": True,
"name": "Weather",
"category": "skill",
"trigger_words": ["weather", "forecast"],
"system_capability": False,
"agent_capability": False,
},
)
This endpoint replaces the installed Ability rather than patching it. Every field below is written on each call, so read the Ability first with List Installed Abilities and send its existing values alongside the one being changed.
string
required
Your OpenHome API key.
integer
required
The installed-capability ID. This is the installed record’s own ID, not the underlying Ability ID.
boolean
required
true to enable, false to disable.string
required
The Ability’s name. Send the existing value.
string
required
One of
skill, brain_skill, background_daemon, or local. Send the existing value.string[]
required
The Ability’s trigger words. This must not be empty. Send the existing values so they are preserved when toggling.
boolean
required
Whether the Ability is a system Ability. Send the existing value.
boolean
required
Whether the Ability is scoped to a single Agent. Send the existing value.
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,
"name": "Weather",
"category": "skill",
"trigger_words": ["weather", "forecast"],
"system_capability": false,
"agent_capability": false
}'
import requests
requests.put(
"https://app.openhome.com/api/capabilities/edit-installed-capability/456/",
headers={"X-API-KEY": "YOUR_KEY"},
json={
"enabled": True,
"name": "Weather",
"category": "skill",
"trigger_words": ["weather", "forecast"],
"system_capability": False,
"agent_capability": False,
},
)